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PREFACE 


The TSS/8 User's Guide is a console-orient'ed manual, written especially for the student, technician, engineer, 
or scientist. This manual presents a functional overview of the operation of TSS/8 (sometimes called 
Time Shared-8) from the user's viewpoint, with precise instructions on how to make efficient use of the TSS/8 
system . 

In particular, the first section is intended to introduce the new user to TSS/8 and provide some insights on how 
TSS/8 enables a single computer to efficiently service the differing needs of many users simultaneously. In 
later sections. Monitor commands are explained in detail, and illustrated by actual examples. Full descriptions 
of a number of System Library Programs are also presented. 


The user of this Guide can be certain that the system operates exactly as explained because each operation has 
been verified on TSS/8, with the actual printout included herein. 


Documents referenced (available from DEC's Program Library): 

TSS/8 System Manoger's Guide, DEC-T8-MBZA-D 

Introduction to Programming, C-18 

Paper Tape System User's Guide, DEC-08-NGCC-D 

FOCAL-8 Programming Manual, DEC-08-AJAD-D 

BASIC-8 Programming Manual, DEC-T8-KJZA-D 

Symbolic Editor, Programmer's Reference Manual, DEC-08-ESAB-D 

PAL-D Assembler, Programmer's Reference Manual, DEC-D8-ASAB-D 

4K FORTRAN, Programmer's Reference Manual, DEC-08-AFCO-D 

KT08/I Time-Sharing Option, DEC-81-H-8NA-D 


IX 



CHAPTER 1 
INTRODUCTION 


1.1 GENERAL DESCRIPTION 

TSS/8 (Time-Sharing System for the PDP-8/I and -8 Computers) is a general-purpose, time-sharing system 
offering up to 16 users (24 in certain applications) a comprehensive library of System Programs. These programs 
provide facilities for editing, assembling, compiling, debugging, loading, saving, calling, and executing user 
programs on-line. Two conversational, interactive systems, FOCAL-8 and BASIC-8tare also included. 

By separating the central processing operations from time-consuming interactions with human users, the computer 
can, in effect, work on a number of programs simultaneously. Cycling between programs and giving only a 
fraction of a second at a time to each program or task, the computer can deal with many users seemingly at 
once. The appearance is created that each user has the computer to himself. The execution of various programs 
is done without their interfering with each other and without lengthy delays In the response to individual users. 

The heart of TSS/8 is a complex of subprograms called the Monitor. Monitor coordinates the operations of the 
various programs and user consoles, ensuring that the user is in contact at all times with his program. Monitor 
allocates the time and services of the computer to the various users; it grants a slice of processing (computing) 
time to each job, and schedules jobs in sequential order to make most efficient use of the system device (disk). 
Monitor handles user requests for hardware operations (reader, punch, etc.), swaps (moves) programs between 
memory and disk, and manages the user's private files. 

1 .2 USER PROGRAMS 

When the user is working on a program with TSS/8, his work exists in the computer as though he had his own 
4K (4096 word) PDP-8. Several users can run programs at virtually the same time, because TSS/8 Monitor con- 
trols the scheduling of execution times. Monitor brings o program into core from the disk, allows it to execute 
for a short time, and takes note of the state at which execution is stopped. Monitor then brings the next user 
program into core, and repeats the process. The user is allotted a 4K block of storage that contains his particular 


tFOCAL-8 (FOrmula CALculator) is an on-line conversational program developed by DEC. BASIC-8 is a 
slightly modified version of the algebraic language originally developed at Dartmouth College. 
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program; this 4K block will be swapped from core onto a 4K area of disk storage when it is necessary for Monitor 
to bring in another program to run. 

After the user's program has been executed, for a period of time it is placed at the end of the queue (line) of 
user programs waiting to run. If only one program is ready to run, it is allowed to do so without interruption 
until another program is ready. 

If a user wishes to maintain a permanent copy of his program, it is necessary to save a copy within the file area 
of the disk (an area separate from the swapping area). Later sections of this manual describe the procedures to 
create and update such files. 

1.3 USER FILES 

A TSS/^ user is any person logged in on TSS/8. Each user has an account number and password assigned to him 
by the installation manager or the person responsible for his particular TSS/^; the account number and password 
allows the user access to the computer. His account number is also used to Identify whatever files the user may 
own within the TSS/8 file system. 

The disk (a large external memory device used for storage of programs and data) is divided into logical areas 
called files. A user can create files and store them in the file storage area of disk. The user can also specify 
which groups of users may access his files and for what purpose (read, write, or both). 

Parts of the disk are used to store System Files; those programs which are accessible to anyone using the computer. 
A major portion of this manual deals with how to use System Files, generally referred to as System Library 
Programs . 

With the appropriate Monitor commands, the user can create new files and manipulate old files (extend, reduce 
or delete them). These commands are explained in Chapter 8. Most individual System Library Programs are 
able to handle user files as input or output with commands Issued at the user's console. 

1 .4 TSS/8 USER CONSOLE 

The user's console is a model 33 ASR Teletype® (Figure 1-1). The console keyboard (Figure 1-2) allows the 
user to communicate with his programs and Monitor. The paper-tape reader and punch are for paper-tape input 
and output, while the teleprinter provides a typed copy of user input as well as program and Monitor output. 

The Teletype controls are described here as they apply to the operation of the computer. Off-line operations 
are explained in Appendix D. 


'Teletype is a registered trademark of the Teletype Corporation. 
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Figure 1-1 User Console 


1.4.1 Power Control Knob 

The following is a description of settings on the power control knob. 


Control 


Function 


LINE The Teletype is energized and connected to the computer 

as an input/output device, under computer control. 

OFF The Teletype is deactivated. 

LOCAL The Teletype is activated for off-line operation. 


1.4.2 Printer 

The printer provides a typed copy of input and output at a maximum rate of 10 characters per second. 
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1.4.3 Keyboard 

The console keyboard is similar to a typewriter keyboard. However, certain operational functions are shown 
on the upper part of some of the keytops. These functions are activated by holding down the CTRL key while 
depressing the desired key. For example, when using the Symbolic Editor, CTRL>^ORM causes Editor to enter 
command mode. 

Although the left and right square brackets are not visible on the keyboard keytops, they are shown in Figure 1-2 
and are generated by typing SHIFT/K and SHIFT/M, respectively. Also, the ALT MODE key is identified as 
ESC (ESCape) on some keyboards. 


0©©(D©(D0©(D000© 

©©o©©©oo©©®©® 

© 0 ©©©© 00 ©© 0 ©©© 

© 00 ©© 0 ®® 00 ©© 

( SPACE I 


Figure 1-2 Console Keyboard 


1 .4.4 Paper-Tape Reader and Punch 

The paper-tape reader is used to input (to a user program) data punched on eight-channel perforated paper tape 
at a rate of 10 characters per second (maximum). The reader control settings are shown in Figure 1-1 and 
described below: 


Control 


Function 


START Activates the reader; reader sprocket wheel is engaged and operative. 

STOP Deactivates the reader; reader sprocket wheel is engaged but not 

operative. 

FREE Deactivates the reader; reader sprocket wheel is disengaged. 


NOTE 

The high-speed reader and punch are described in 
Appendix E. 
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1 .4.5 PosiHoning Tape in the Tape Reader 

The following procedure describes how to properly position paper tape in the low-speed reader. 

a . Raise the tape retainer cover . 

b . Set reader control to FREE . 

c. Position tape to fit in the carrier and over sprocket wheels. 

d . Close the tape retainer cover. 

e. Tape should be able to be drawn through low-speed reader in either direction while the control is 
set to FREE. 

1 .5 USE OF THIS MANUAL 

At this point, the user has a general understanding of time-sharing and how it is done. The following chapters 
describe how to use the system, and include summaries of the various System Library Programs available arnl how 
to use them. Chapter 2 describes the elementary Monitor commands every user will require. Chapter 3, Sec- 
tion 3. 1 describes the System Library. Section 3. 1 assists the user in learning to gain access to (in computer 
(argon "to access") files and control execution, and includes a list of more detailed manuals on each of the 
TSS/8 System Library Programs. A glossary of terms and an Index appears at the end of this manual . 
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CHAPTER 2 

ELEMENTARY MONITOR COMMANDS 


TSS/8 offers the user a variety of hardware and software resources. The TSS/8 Monitor controls the allocation 
and use of these resources. Many of the functions of the Monitor are invisible, and of no concern to the user, 
for example, the way it allows many users to run programs on a single computer. In other instances the user 
explicitly tells Monitor what he would like to do and the resources he wishes to utilize. He does so by typing 
one or more of the commands described in this chapter or Chapter 8 (Advanced Monitor Commands). 

The Monitor commands described in the first half of this chapter are those the user needs to log into the system, 
to utilize the TSS/8 System Library Programs, and to log out of the system. All TSS/S users must be familiar with 
these commands. The commands described in sections 2.5, 2.6, and 2.7 are not needed to run TSS/8 System 
Library Programs such as BASIC and FOCAL, but are frequently useful. The Monitor commands described in 
Chapter 8 are primarily useful for creating assembly language programs and files. 

NOTE 

All Monitor commands must be terminated by typing the 
RETURN key. All words within a Monitor command 
line are separated by one or more spaces. 


2.1 CALLING MONITOR 

The user enters commands to System Programs, such as BASIC and FOCAL, in exactly the same way that he 
enters commands to Monitor (i .e. , by typing them In at the keyboard); therefore, the system must have some 
way of distinguishing between the two cases. It does so by defining two modes of console operation; Monitor 
mode and program mode. When a user's console is in Monitor mode, all input is interpreted os being commands 
to Monitor. Otherwise, all input is assumed to be to the user program. 

A special character, CTRL/B, (obtained by striking B with the CTRL key held down; ar>d echoed on the Teletype 
as IB) is used to unconditionally place the user's console in Monitor mode. Typing CTRL/B tells the system that 
the command to follow is to be interpreted as a command to Monitor, regardless of the mode that the Teletype is 
in. Generally, the command which follows the CTRL/B will be the S command. 
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tBS 


Return to Monitor mode. 


TBtBS Return to Monitor mode from a program which is typing 

out. (The two CTRL/b's stop the typeout, allowing the 
S command to be typed . ) 

It is not necessary to precede each Monitor command with CTRL/B. Once In Monitor mode, a console stays in 
that mode until a command is typed which starts a user program. To signify that it Is in Monitor mode, the 
system types a dot (.) on the left margin of the console printer paper. This dot indicates that the characters 
typed in next will be treated as a Monitor command. Thus, the CTRL/B capability is important when a user is 
running a program and wishes to type a Monitor command. He may, for example, be using one language 
(or System Program) and want to change to another, as shown below. 

•R FOCAL 

CC\1GRATULATI0MS! ! 

YOU HAVE SUCCESSFULLY LOADED 'F0CALj1969' ON A TSS-8/I COMPUTER. 

SHALL I RETAIN LOCj EXP j ATN ?:N0 
SHALL I RETAIN SINE^ COSINE ?:N0 
PROCEED. 

* 

tBS 

.R BASIC 
NEVI OR OLD-- 

Monitor always responds to tBS by typing a dot at the left-hand margin. 

2.2 LOGGING IN ON TSS/8 

To prevent unauthorized usage and to allow Monitor to maintain a record of system usage, TSS/8 requires that 
each user identify himself to the system before using it. Before attempting to log in, the user should ensure that 
the console LINE/OFF/LOCAL knob is turned to the LINE position (see section 1.4.1) before striking the 
RETURN key. If the console Is connected to TSS/8 and is not already in use. Monitor rolls the console paper 
up two lines and prints a dot at the left margin of the paper. 

The dot indicates that TSS/8 is in Monitor mode and that Monitor is waiting for the user to issue a command. 
LOGIN Request access to TSS/8. 
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The LOGIN command allows the user to access the TSS/8 system. 


The user types LOGIN followed by a valid account number and password. Providing the console is free (not 
already logged in), the command, account number, and password will not be printed on the console paper as 
the keys are typed. If the command name letters are being printed, stop typing the command; instead, strike 
the RETURN key, log out using the LOGOUT command (see section 2.3), at this point a successful LOGIN can 
be accomplished. The LOGIN command Is formatted as shown below; 

.LOGIM 123^ ABCD (only the dot is printed) 

where . is printed by Monitor, LOGIN is the command name, 1234 represents the account number, and ABCD 
represents the password . 

NOTE 

A command name and each parameter (except the last) 
is always followed by a space, and the command line 
is always terminated with the RETURN key. 

When a user types something other than a valid LOGIN command on a console. Monitor responds in one of the 
following ways. 


Response 


Explanation 


HELLO? 


(user typed HELLO) 


LOGIN PLEASE? 


(user typed ASSIGN D 3) 


ILLEGAL REQUEST 


(user typed LOGIN ABCD ABCD) 


.LOGIN 4771 DENC (user typed valid LOGI N on an already logged in 

ALREADY LOGGED IN console) 

. (user typed an incorrect account number or password) 

UNAUTHORIZED AGCOUNT 


In the first example, HELLO is not a command, so it is repeated with a question mark by Monitor. In the 
second example, ASSIGN D 3 is a valid command but it is not appropriate until after the user logs in; therefore. 
Monitor asks the user to log in. In the third example. Monitor finds that the LOGIN command is improperly 
formatted (the first parameter must be from one to four numbers). The console printout tells the user that he has 
made an ILLEGAL REQUEST. When the console is already logged in and the user types the LOGIN command, 
the characters typed echo at the console, and Monitor informs the user that the console is occupied with the 
message ALREADY LOGGED IN? If the user attempts to use an incorrect account number or password. Monitor 
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replies UNAUTHORIZED ACCOUNT. Thus, Monitor can distinguish an invalid command from a valid command; 
it can also distinguish whether the valid command is appropriate when issued, whether the command is properly 
formatted, and whether the account number and password are acceptable. In all the examples above. Monitor 
igrrares the command and prints another dot. 

When Monitor finds the LOGIN command properly formatted and the account number and passwords acceptable, 
it responds by identifying the version of the system being used, the job number it has assigned to the user, the 
number of the console being used, and the time-of-day in hours, minutes, and seconds. For example; 

TSS/8.19 JOB 03 K01 08:45:21 

AMD USUALLY THE SYSTEM MAMAGER WILL ENTER 
HERE A COMMENT OR NOTE TO THE USER CONCERNING 
THE SYSTEM 


Monitor then prints another dot and waits for the user to issue the next command. The job number assigned is an 
internal number by which the system identifies each on-line user. 

2 .3 LOGGING OUT OF TSS/8 

The LOGIN command tells Monitor that the user is ready to begin an on-line session. The LOGOUT command 
indicates that the user is finished and ready to leave his Teletype. 

LOGOUT Disconnect the user from the system and record the 

amount of time he has used. 

Monitor responds to LOGOUT by typing the amount of computer time used in the session and the total real time 
of the session. For example: 


.LOGOUT 

RUN TIME 00:00:34 ELAPSED TIME 00:35:41 
PLEASE TURN OFF YOUR TTY 


Computer time used in this example was thirty four seconds, while the elapsed time between LOGIN and 
LOGOUT was thirty five minutes and forty one seconds. 


2.4 SYSTEM LIBRARY PROGRAM CONTROL 

Once logged in, the user can call any of the TSS/^ Library Programs described in Chapters 3 through 7. To 
call such a program, the user types the command R (meaning run) followed by one or more spaces and the pro- 
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R 


Call in and start a TSS/8 System Library Program. 


For example: 


.R BASIC 
MEV OR OLD -- 

Monitor fetches the BASIC language processor from the System Library and starts it. BASIC begins its dialogue 
by asking if the user wishes to work on a new program or retrieve an old one from disk storage. Notice that 
once BASIC begins, the console is no longer in Monitor mode. Dots are no longer printed at the margin. All 
input is considered to be commands to BASIC. 

If the user types a program name which cannot be found in the System Library, Monitor responds with an error 
message and returns the console to Monitor mode. 

•R BASICK 
FILE MOT FOUND? 

• 

The exact contents of a TSS/8 System Library may vary from installation to installation. 

2.5 COMMUNICATION WITH OTHER USERS 

Although TSS/8 gives each system user the Impression that he is the only user of the system, it is actually 
supporting many users at a time. Often, it Is useful to communicate with another user, or with the system 
operator; this is done through use of the TALK command. 

TALK Type out a message on another TSS/8 Teletype. 

For example, to tell the system operator (Teletype 0) to turn on the high-speed punch, a user types the following 
(where the initial dot was typed by AAsnitor): 

•TALK 0 PLEASE TURN ON THE HIGH SPEED PUNCH 

This command causes the following to be typed on console 0: 

** K0 7** PLEASE TURN ON THE HIGH SPEED PUIMCH 

where K07 Is the number of the physical console which sent the message. Any Teletype can initiate a message 
to any other Teletype. However, if the destination Teletype is printing at that time, the message will not be 
sent. The initiating Teletype will, in this case, get the message BUSY as a response. 
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2 .6 SYSTEM STATUS REPORTS 


The command SYSTAT tnitiates a typeout of the full status of TSS/8; how many users are on-line, what they are 
doing, etc. 

SYSTAT Report system status . 

The command SYSTAT is equivalent to typing R SYSTAT. The format of the status report is described in the 
section on SYSTAT in Chapter 6. 

To learn the amount of computer time used since logging in, the user issues the TIME command: 

time The elapsed processor time of the user since he logged in 

is printed. 

TIME 0 The time of day is printed . 

TIME Cl The amount of processor time used by job Cl since login 

is printed. 


For example: 

• TIME 
00:00:09 


.TIME 0 
09:29:32 


.TIME 02 
00 : 00:10 

2.7 RESOURCE SHARING 

All TSS/8 users, when logged in, have free access to the System Library, the disk storage capability, and the 
TSS/8 computer. Monitor automatically handles resource requests on a rotating basis. Monitor also maintains 
a pool of available devices which must be assigned to be used. These are devices, such as the high-speed 
paper-tape reader, which by their very nature cannot be assigned to several programs simultaneously. Therefore, 
Monitor grants individual users exclusive access to these devices when needed. Thus, users still share the 
device, although not simultaneously. 
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All TSS/8 systems include a high-speed, pofier-tape reader in the pool of available devices. Many systems also 
include a high-speed, paper-tape punch, and one or more DECtapes. These assignable devices are normally 
used with System Library Programs PIP and COPY to store programs or data on paper tape or DECtape. 

When a device is assignable (present on the system) and available (not being used), the ASSIGN command may 
be used to assign the desired unit or units to the console issuing the command. The valid ASSIGN commands are 
formatted as shown below: 

ASSIGN R Assign the high-speed paper-tape reader. 

ASSIGN P Assign the high-speed paper-tape punch. 

ASSIGN D Assign a DECtape unit. 

where R, P, and D are device designators for reader, punch, and DECtape, respectively. If other devices are 
assignable, the system manager will inform the user of the appropriate device designators. The following is an 
example of using an invalid device designator. 

.ASSIGN X 
ILLEGAL REQUEST 


Monitor ignores the request, responds with the appropriate message, and prints another dot. 


When a valid ASSIGN command is issued, AAanitor checks for the availability of the device ond responds 
accordingly. For example: 


.ASSIGN R 
R ASSIGNED 


(reader is assigrxible, available, and assigned) 


.ASSIGN P 
JOB 02 HAS P 


(punch is unavailable because job number is using 
it, and thus not assigned) 


When the system contains multiple units of a device, the user simply specifies the device; Monitor assigns an 
available unit and responds with the unit number. For example: 

.ASSIGN D 
D 2 ASSIGNED 


If all DECtape units are busy. Monitor prints the message shown below: 


.ASSIGN D 

DEVICE NOT AVAILABLE 
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A specific unit can be requested, leaving a space between the device designator and the device number. 


.ASSIGN D 4 
D 4 ASSIGNED 


(assignment was accomplished) 


NOTE 

If the user assigns a device with a nonexistent device 
number, that device will not be assigned; an error 
message does not result because that device is not busy. 

An error message only results when the device is already 
assigned . 

The ASSIGN command can assign only one device at a time. Therefore, when multiple devices are to be 
assigned, each must be assigned separately. The following will not accomplish the desired assignments, either 
with or without the illegal commas. 

.ASSIGN Rj D 2:. D 1 
R ASSIGNED 


Monitor accepted the first device designator (and unit number if any) and ignored the rest of the command. If 
device R is unavailable, AAonitor prints the appropriate message. The following completes the desired assign- 
ments (assuming available devices). 


.ASSIGN D 2 
D 2 ASSIGNED 


.ASSIGN D 1 
D 1 ASSIGNED 


When the user has finished working with an assigned device, the RELEASE command must be used to terminate 
the assignment and allow other users access to the device. (When a user logs out of TSS/8 any devices he still 
has assigned to him are automatically released.) 

RELEASE Terminate a previous device assignment and make the 

device available to other users. 

An assigned device is released when the user types the RELEASE command, a space, the device designator (and 
unit number if required), and the RETURN key as shown below. 


.RELEASE R 
.RELEASE D 3 


2-8 



In the previous example, the reader and DECtape unit number 3 are released. Monitor prints a dot on the next 
line if the release is accomplished; otherwise, it prints a message. If, for example, o request is mode to release 
o device which has not been assigned to the issuing console, the following happens: 


•RELEASE P 
ILLEGAL REQUEST 


Monitor printed ILLEGAL REQUEST after it checked and found that the specified device was not assigned to the 
console issuing the command. 


NOTE 

All commands must be formatted properly; ILLEGAL 
REQUEST is printed if the user fails to separate the 
device designator and unit number with a space. 


When multiple device units exist on the system, each must be individually released. For example: 


.RELEASE D 1 
.RELEASE D 2 
.RELEASE R 


Monitor does not check when releasing a device as it does when checking to assign an available device. The 
user could have two device units (for example, two DECtape units) assigned and Monitor would not know which 
to release; therefore, device numbers are necessary with a RELEASE command. However, where only one unit 
of a specific device (one reader, one purKh, etc.) is on the system, the device designator alone is sufficient. 
Examples follow. 


.RELEASE D 
ILLEGAL REQUEST 

.RE.LEASE R 
.RELEASE D 1 


(doe to multiple DECtape units) 
(accomplished) 

(D 1 is released) 


2.8 ERROR MESSAGES 

An appropriate error message is printed whenever: a Monitor command cannot be performed at the time it was 
requested, a typing error was made, or the command is illegal (nonexistent). Following each error message. 
Monitor ignores the request and prints another dot, after which the user can issue another command. 
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Table 2-1 

Monitor Error Messages 


Command 

Explanation 

SI? 

The System Interpreter does not understand the command . 

SI = command 

LOGIN PLEASE? 

The user attempted fro use a console which Is nofr logged 
in» 

UNAUTHORIZED ACCOUNT 

The user attempted to log into the system with an invalid 
account number or name. 

ALREADY LOGGED IN? 

The user fried fro log in on a console which is already in 
use. 

FULL 

The TSS/8 system is full . Another user cannot log in 
until one of the present on-line users logs out. 

TYPE IBS FIRST 

The user attempted to use a system command which 
cannot presently be honored due to the status of the 
user's program. The message may appear even after the 
user has typed tBS, since his program may continue until 
the I/O in progress at the time of the halt is completed. 
The user should wait a few seconds and then type his 
command a second time. 

ILLEGAL REQUEST 

The user requested an illegal command. This error 
usually results when some parameter has been given an 
incorrect value or the request refers to a facility not 
owned by the user. 

BUSY 

The user attempted to talk to a console which is 
currently typing out or is being typed on. 
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CHAPTER 3 


DESCRIPTION OF TSS/8 SYSTEM LIBRARY PROGRAMS 
AND THE INTERACTIVE LANGUAGES 


3.1 INTRODUCTION 

The TSS/8 System Library contains a comprehensive set cS user programs for a wide range of applications. 
Language processors, such as BASIC-8, FOCAL, and FORTRAN, allow the user to code and run programs 
in interactive languages. A complete assembly language system allows programs to be written in PAL-D. 
Various utility programs perform special functions. The System Library consists of the following programs: 


a. BASIC-8 - an easily learned algebraic language originally developed at Dartmouth College. 

b. FOCAL - dec's own conversational language for on-line problem solving. 

c. FORTRAN-D - a modified version of FORTRAN. 

d . EDIT - 0 keyboard oriented Symbolic Editor, used to create and modify source programs and data 
files. 

e. PAL-D - a two-pass Symbolic Assembler. 

f. LOADER - a Binary Loader used to load assembled programs for execution. 

g. ODT - Octal Debugging Technique for testing and modifying assembly language programs. 

h. PIP - Peripheral Interchange Program for transferring files between the TSS/8 disk and paper tape. 

i. COPY - a utility program used to transfer files between the TSS/8 disk and DECtope. 

[. CAT - used to list all the files which a user has stored in his library. 

k. SYSTAT - (System Status) a utility program that prints the status of the whole TSS/8 system. 

A more detailed description of each of the above System Programs is presented in the following chapters. 

3.2 GENERAL CHARACTERISTICS OF SYSTEM LIBRARY PROGRAMS 

A fundamental feature of the TSS/8 Monitor is its ability to save programs or other data for each user in his own 
private library. These individual user libraries are maintained on the system disk. Individual entries in the 
library are called files, whether they contain programs or data. Within the library itself, there is no distinction 
between types of files by their contents. Each file is identified with a file name by which it is known, and 
called into use. 
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The user does not directly create and update the files in his library. He uses the System Library Programs for 
this purpose. For example, he can use the SAVE command in BASIC. The SAVE command takes the BASIC 
program iKimed and saves it as a file in the user's library for future use. Similarly, EDIT can be used to modify 
an existing file, resulting in the creation of a new file. Therefore, although TSS/8 Monitor provides the actual 
file storage capability, most file manipulation is done while System Library Programs are being run. 

The System Library Programs which operate on these files, must know which file to use, when to create a new 
file, and what to call it. Each Library Program has its own method of determining whether a user wishes to use 
an old file or create a new one; this is explained in the sections on individual programs. 

Example 1: 

.R BASIC 

NEW OR OLD--OLD 

OLD PROGRAM NAME--PRIME 

READY 

Example 2: 

•R FORT 
INPUT: TYPE 
OUTPUT .-BTYPE 

For most of his work, the user requires access to only his own library. However, it is often a useful feature to 
be able to obtain a program from another user's library; allowing a single file to be shared by several users. To 
access a program from another user's library, the user must tell the system in which individual library the file is 
stored. The user tells the system by entering the account number of the library's owner. (In the absence of an 
account number, the user's own library is the assumed source.) To get a file from the System Library, type an 
asterisk immediately after the file name. 

Example 1: 

.R BASIC 

NEW OR OLD--OLD 

OLD PROGRAM NAME--HOSSR* 

READY 

Example 2: 


.R PALD 

INPUTiNOTPIP 5AA0 
0UTPUT:BIN1 
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NOTE 


Most examples in the discussions of individual System 
Library Programs use file names within the user's own 
library. The user is free (file protect permitting) to 
use files from other users' libraries. 

Access to another user's files is gained only with his permission. A user may "protect" his files against other 
users (see Appendix F), i .e. , prevent them from gaining access to his files, even though they know his program 
name and account number. Library Programs never permit a user to write in another user's files. Specifying a 
file which is protected, or specifying a nonexistent file, is an error that is detected immediately. An error 
message is typed and the same request made again. 

The user places his output in a single file; however, it is often useful to input several files together. (For 
example, the user may wish to assemble two parts of a PAL-D program together.) To specify more than one 
input file, separate the file names by commas. No Library Program allows more than three input files. 
FORTRAN is limited to two; BASIC allows only one. 

BASIC is a self-contained programming system, with an editor, compiler, and run-time system. It also has a 
distinctive disk file format. Files created by BASIC are not compatible with files created by other Library 
Programs. All other Library Programs depend on each other; therefore, all Library Programs use the same format 
for their disk files. Consequently, files created by the Editor can be used as input to PAL-D or FORTRAN-D, 
and numerical files created with the use of the Editor can be read by FORTRAN programs as data files. 

Up to this point, only files that exist within the Time-Sharing System, i .e. , on the TSS/8 disk, have been 
described; however, TSS/8 provides two other means of file storage: paper tape and DECtape. The Library 
Program PIP can be used to transfer files between paper tape and disk. The Library Program COPY allows files 
to be transferred between disk and DECtape. 

3.2.1 Controlling the Execution of System Library Programs 

TSS/8 provides the user with two options for stopping the system . CTRL/C (C with the CONTROL key held 
down) allows the user to stop his BASIC program and return to the beginning of that program without returning to 
the TSS/8 Monitor. For example, if the user begins to run a BASIC program that has an endless loop, he can 
type CTRl/C to stop it. BASIC responds to tC with READY. All other Library Programs respond in a similar 
manner. 

CTRL/b is used to stop the Library Program most recently called. CTRL/fe followed by S and carriage return 
(RETURN key) unconditionally returns the user to the Monitor level; the user can now call another Library 
Program. If the system is typing out, two CTRL/Bs and the S (tBtBS) are required to stop the system. 
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RUBOUT is another useful character that deletes the last typed character. Some Library fVograms respond bv 
printing \ or while others print the rubbed out character. If the RUBOUT key is typed while entering file 
names for input or output to a Library Program, RUBOUT deletes the whole line. The request for input or output 
is then repeated. 

3.2.2 Returning to Monitor 

The user can stop the execution of a System Library Program at any time by typing CTRL/fe followed by S and the 
RETURN key. The System Library Programs can also initiate a return to the Monitor. When the System Library 
Programs initate a return, IBS is printed just as though the user had terminated the program. For example, 
BASIC-8 returns to Monitor when the user types the BYE command: 

READY 

BYE 

tBS 

FORTRAN returns to Monitor after completing execution of a program. CAT and SYSTAT return after typing 
their particular data output. PAL-D returns after completion of an assembly, LOADER at the end of a normal 
load, and EDIT after completion of an EDIT. FOCAL, BASIC, ODT, PIP, and COPY never return to Monitor; 
these programs must be terminated by the user. 

NOTE 

Some System Library Programs return to the Monitor when 
a fatal error condition is detected. 


3.2.3 Additional Manuals 

Many of the System Library Programs are documented in their own Individual manuals. Those programs for 
which manuals exist, are: 


BASIC -8 

FOCAL 

EDIT 

FORTRAN-D 

PAL-D 

ODT 


DEC-T8-KJZA-D 

DEC-08-AJAD-D 

DEC-08-ESAB-D 

DEC-08-AFCO-D 

DEC-D8-ASAB-D 

DEC-08-COCO-D 


Only a brief description of these programs is given here. Tables of commands are included for reference; how- 
ever, for detailed instructions on the usage of these programs, the user is referred to the individual manual . 
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3.3 BASlC-8 


BASlC-8 is fhe TSS/8 version of fhe time-shoring language BASIC. It allows even the beginning computer user 
to write and run meaningful programs. BASlC-8 is described at greater length in the BASIC-8 Manual (Order 
No. DEC-T8-KJZA-D). To call BASIC, type: 

•R BASIC 

After the user logs into TSS/8, and calls the BASIC program, BASIC then prints NEW OR OLD — . The user then 
types the appropriate adjective: NEW (if the user is about to type a new program), or OLD (if the user wants 
to access a program that was previously filed). 

BASIC asks NEW PROGRAM NAME — (or OLD PROGRAM NAME — ) and the user types any combination of six 
letters or less. If the user is recalling an old program file from memory, he must use exactly the same name as 
when he originally instructed BASIC to save it. 

BASIC prints READY to signal the start of the editing phase; the user then begins to type the new program. If 
the user types a line consisting of only a line number followed by the RETURN key, that line is deleted. Make 
certain that each line begins with a line number greater than 0 and less than 2047 and contains no non-digit 
characters. To enter the line to the computer be sure to strike the RETURN key at the completion of each 
line. 

If, while typing a statement, the user makes a typing error and notices it immediately; he can correct it by 
striking the RUBOUT key (right-hand side of the keyboard), or the back arrow key (SHIFT/O). Striking either 
key deletes the character in the preceding space and prints a left arrow ("^ for each rubout. The user can then 
type in the correct character. Striking the RUBOUT key a number of times erases one character from the 
current line, (spaces are characters) to the left for each RUBOUT typed. 

NOTE 

BASIC sometimes takes several seconds to accomplish 
a rubout. 

While BASIC is in the editing phase, certain additional commands (which must not have line numbers) are avail- 
able and are described below: 

a. If the user types SAVE followed by one or more spaces, followed by a name, and strikes the 
RETURN key, the current program is saved for future use under that name. 

b. If the user types UNSAVE, followed by a name, and strikes the RETURN key, the program with the 
name given is deleted from the user's permanent file. 

c. If the user types CATALOG , and strikes the RETURN key, a listing of all the program names in 
his permanent file is typed. 
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NOTE 


Names of temporary files are also shown. These are of 
the form, BASnn, and can be ignored. 

d. If the user types LIST followed by two line numbers separated by a comma, a listing of the particular 
part of his current program that lies between those line numbers is typed. If the comma and second line 
number are omitted, only the single line indicated is listed. If no line numbers follow the word LIST 
(but only the RETURN key), the whole program is listed. 

e. If the user types DELETE followed by two line numbers separated by a comma, all lines between and 
including the two indicated are deleted. If the comma and second line number are omitted, only the 
single line specified is omitted. 

f. When the user is ready to leave the Teletype, he signs off by typing BYE. BYE concludes 
operations and TTS/8 Monitor deletes any tempory files assigned to the user. 

g. After BASIC is called, the user can load a BASIC program from paper tape by placing the tape in 
the console tape reader and typing TAPE. The tape is read in without printing on the console paper. 

All RUBOUT characters are ignored. 

h. After loading a tape, type KEY to return to normal keyboard mode. (Characters typed while in 
TAPE mode do not echo on the console paper.) 


If information (other than the RETURN key) is to follow the control word, at least one blank must precede the 
additional information. 


3.3.1 Example of a BASIC-8 Program 


LIST 

10 REM - PROGRAM TO COMPUTE INTEREST OX A LCAX 

20 PRINT "INTEREST IN PERCENT"; 

30 INPUT J 

40 LE.T J=J/100 

50 PRINT "AMOUNT OF LOAN"; 

60 INPUT A 

70 print "NUMBER OF YEARS”; 

80 INPUT N 

90 PRINT "NUMBER OF PAYMENTS PER YEAR"; 

100 INPUT M 

1 10 LET N=N*M 

120 LET I=J/M 

130 LET B=l+I 

140 LET R=A*I/(l-l/BtN) 

150 PRINT "MiONThLT PAYMENT ="R 
160 PRINT "TOTAL INTEREST ="R*N-A 
1 70 END 
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READY 


RUN 

INTEREST IN PERCENT? 8 

AMOUNT OF LOAN? 25000 

NUMBER OF YEARS? 20 

NUMBER OF PAYMENTS PER YEAR? 12 

MONTHLY PAYMENT = 209.1103 

TOTAL INTEREST = 25186.A6 


READY 


3.3.2 Summary of BASIC-8 Stafemenfs 
Table 3-1 is a summary of BASlC-8 sfafemenfs. 


The followirtg is a list of symbols used in Table 3-1. 

n = line number 
s = integer subscript value 
d = data, either real or integer 


Table 3-1 

Summary of BASIC-8 Statements 


Statement 

Explanation 

LET V = f 

Assign the value of the formula to the specified 
variable. 

DATA d , . . . , d 

DATA statements are used to supply one or more 
numbers to be accessed by READ statements. 

READ V, . . . , V 

READ statements, in turn, assign the next available 
number in the DATA string to the variables listed. 

PRINT a, ..., a 

Type the values of the specified arguments, which 
may be varieties, text, or format control characters. 

GOTO n 

Transfer control to the line number specified and 
continue execution from that point. 

11f (f r f) THEN n "1 

If the stated relationship is true, then transfer control 

p (f r f) GO TO nj 

to the line number specified; if not, continue in 
sequence . 

FOR V = f^ TO f2 STEP f^ 

Used for looping repetitively through a series of steps. 

The FOR statement initializes the variable to the value 
of formula If the increment is positive and the 

variable <formola 2/ fhe instructions following are 
executed until the NEXT statement is encountered. 


V = variable 
f = formula 
r = relationship 
a = arguments 
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Table 3-1 (Cent) 
Summary of BASIC -8 Statements 


Statement 

Explanation 

NEXT V 

The NEXT statement increments the variable by the 
value of formula ^ (if omitted, the increment value is 
+ 1). The variable is again tested os described above, 
and this process continues until the loop is repeated the 
specified number of times. When the variable becomes 
larger than formula 2i control goes to the statement fol- 
lowing the NEXT. If the increment (formula 3 ) is neg- 
ative, then the instructions between the FOR and NEXT 
statements are executed until the variable becomes less 
than the value of formula 2 ~ 

DIM V (s) 

Enables the user to enter a table or array with the 
specified number of elements. 

END 

Last statement to be executed in the program . This 
statement must be present. 

RANDOMIZE 

When placed at the start of a program, causes a 
different set of random numbers to be generated each 
time that program, using RND (X), is run. 

GOSUB n 

Transfers control to the subroutine beginning at the 
line number indicated. 

RETURN 

RETURN simplifies the execution of a subroutine by 
providing an automatic return from the subroutine to 
the next sequential statement following the appropriate 
GOSUB (the GOSUB which sent control to the sub- 
routine). 

INPUT V, ..., V 

Causes typeout of a ? to the user and waits for user to 
respond by typing the value of the variable(s). 

STOP 

Equivalent to GO TO [line number of END statement] . 

REM 

Permits typing of remarks within the program. 

RESTORE 

Sets pointer back to beginning of string of DATA values. 


3.3.3 Functions 

BASIC performs several mathematical calculations for the programmer eliminating the need for tables of 
trigonometric functions, square roots and logarithms. These functions have a three-letter call name, (the 
argument (X) can be a number, variable or formula) and are written as follows: 
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Functions 

Meaning 

SIN 

(x) 

sine of X in radians 

COS 

(x) 

cosine of x in radians 

TAN 

(x) 

tangent of x in radians 

ATN 

(x) 

arctangent of x in radians 

EXP 

(x) 

e^ where e=2. 712818 

LOG 

(x) 

natural logarithm of x, log^x 

ABS 

(x) 

absolute value of x, |x| 

SQR 

(x) 

square root of x , \/x 


3.3.4 Complex Functions 

o. SGN (x) - the SGN or sign function returns the value +1 if x is o positive number, 0 if x is 0, 
and -1 if X is negative. For example: SGN (3.42) =1, SGN (-42)=-!. 

b. INT (x) - the INT or Integer function returns the value of the greatest integer not greater than x. 
For example; INT (34.67) =34, INT (-34.42) =-35. 

c. RND (x) - the RND or random number function produces a random number between 0 and 1. The 
numbers are reproducible in the same order for later checking of a program. The value of x is ignored. 
If a truly random number generator (causing different random numbers every time the program runs) is 
desired, place the RANDOMIZE statement at the beginning of the program, before the initial use of 
RND(x). 

d. User defined functions - The user may create his own functions by using the DEF statement. The 
statement defining the function must appear before any reference to that function, its form is: 

DEF FNA (x) = (some formula) where the function name must be a three-letter sequence beginning 
with F . 

3.3.5 Summary of Edit and Control Commands 

Several commands for editing BASIC programs and controlling their execution enable the user to: delete lines, 
list his program, save programs on a file-structured storage device (disk), delete or replace old programs on 
the storage device with new programs, call in programs from the storage device, etc. These commends are 
summarized below. 
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Table 3-2 

Summary of BASIC Edit and Control Commands 


Command 

Action 

BYE 

Exit to TSS/8 Monitor to conclude operations 

DELETE n 

Delete line number n (or simply type the line number and RETURN key). 

DELETE m, n 

Delete line numbers m through n. 

LIST 

List program. 

LIST n 

List line number n. 

LIST m, n 

List program from line number m through n. 

NEW 

BASIC will ask for a new program name. 

OLD 

BASIC will ask for the old program name and will replace current contents of 
user core with the program of the given name from the storage device. 

RUN 

Compile and run program currently in core. 

SAVE name 

Save the BASIC program currently being worked on under the name given. ^ 

UNSAVE name 

Delete the named program from the storage device. 

fC (CTRL/C) 

To stop a running program, type CTRL/C (C with the CONTROL key held 
down). BASIC will return to editing mode and type READY. 

^SAVE commands overwrite an existing file of the same name. 


3.3.6 Error Messages 

There are four types of BASIC error messages. The messages and their various interpretations are shown below. 


3.3.6. 1 Editing Phase Diagnostics - Retype the line to correct it. 


Error Message 

SYSTEM I-O ERROR 
//ERROR 0 ] 

//ERROR 02 
//ERROR 03 
//ERROR 04 
//ERROR 1 1 
WHAT? 

//Error 20 


Explanation 

BASIC was unable to perform the desired disk l/O. 

The user did not type in OLD or NEW when the in- 
formation was requested. 

The new or old name is not a valid name. 

The new name given is currently an active program. 

The old program name requested cannot be found. 

The SAVE or UNSAVE name given is not a valid name. 

The editor cannot understand the command given. 

Invalid line number format or outside the range 
0 < line number < 2047. 
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3. 3. 6. 2 CompilaHon and ExecuMon Diagnostics - Most messages are followed by the notation ON LINE nnnn, 
where nnnn is the line number on which the error was detected. (BASIC prints READY and the user is back in 
the editing phase.) 


Error Message 

Explanation 

PROGRAM TOO LARGE 

The program is too large to be executed . Make it 
smaller. 

MISSING END STATEMENT 

All programs must have an END statement. 

DATA POOL OVERFLOW 

The user used too many constants and/or variables in the 
program . 

ILLEGAL STATEMENT 

A statement was used which is not one of the legitimate 
BASIC statements. 

ILLEGAL LINE FORAMT 

The structure of the statement does not agree with the 
BASIC syntax. 

NOT CONSTANT IN DATA 

The user attempted to use something other than a con- 
stant in a DATA statement. 

DEF STATEMENT MISSING 

A function needing a DEF statement exists in the 
program . 

FOR WITHOUT NEXT 

There is an unmatched FOR statement in the program. 

NEXT WITHOUT FOR 

The NEXT statement indicated has no preceding FOR 
statement . 

ILLEGAL CHARACTER 

The user attempted to use an illegal character in the 
statement being processed. 

ILLEGAL CONSTANT 

The format of a constant in the statement being processed 
is not valid . 

INVALID NAME 

A name is being used which does not agree with the 

BASIC requirements. 

INVALID LINE NUMBER 

The format of the line number, being used in a GO TO 
or IF statement, is not acceptable. 

ARRAY USED BEFORE DEFINED 

The user attempted to use an array prior to its appearance 
in a DIM statement. 

EXPRESSION SYNTAX 

The expression being processed does not agree with the 
BASIC rules (this will probably be due to unmatched 
parentheses) . 

STACK OVERFLOW 

The user programmed a situation in which either DO 
statements, subroutines, or functions are nested too 
deeply; or the user has a function which calls itself. 

OUT OF DATA 

An attempt was made to READ more data than was 
supplied by the user. 

ILLEGAL INPUT FORMAT 

The form of a constant, which the user is attempting to 
INPUT, is not valid. 

DIMENSION TOO LARGE 

Too large an array to fit in the core available. 

UNDEFINED LINE NUMBER 

The line number appearing in a GO TO or an IF-THEN 
statement does not appear in the program. 
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3. 3. 6. 3 Non-Fatal Execution Errors - Non-fatal errors are for notification purposes and indicate that the user 
performed a computational range error. The errors all cause the message XX IN nnnn to be printed, where nnnn 
is the line number and XX is as described below: 


Error Code 


Explanation 


/<^ 

OV 

UN 

LN 

SQ 

PW 


ZERO DIVIDE - An attempt was made to divide a number 
by zero. The largest possible number is used for the 
result. 

OVERFLOW - The result of a calculation was too large 
for the computer to handle. The largest possible number 
is used for the result. 

UNDERFLOW - The result of a calculation was too 
small for the computer to handle. Zero is used for the 
result. 

An attempt was made to compute the logarithm of zero 
or a negative number. Zero is used for the result. 

An attempt was made to compute the square root of a 
negative number. The square root of the absolute value 
is used for the result. 

An attempt was made to raise a negative number to a 
fractional power. The absolute value of that number 
raised to the fractional power is used. 


3. 3. 6. 4 System Error - If a failure occurs in the disk l/O portion of the BASIC system, the message SYSTEM 
l/O ERROR is printed and control returns to the editing phase. 


3.3.7 Implementation Notes 

The TSS/8 BASIC language is compatible with Dartmouth BASIC except as noted below: 

a. There are no matrix operations. 

b. There are no character string instructions. 

c. The ON statement has not been implemented. 

d. The TAB function is not available in PRINT statements. 

e. BASIC-8 has no features which allow reading or writing data on the disk. (Although programs may 
be saved on the disk for future use.) 

f. All array (subscripted) variables must appear in a DIM statement. 

g. The function INT (X) gives the greatest integer in X. Therefore, INT (-2.3) gives the value -3; 
INT (2.3) gives the value +2 

h. Negative numbers can tiv.r be raised to integer powers. The absolute value is used and an error 
message printed. The reason for this is the unary minus has a lower priority during execution than 
exponentiation. For example, -2^ = +8 with an error message given. 
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i , User defined functions are restricted to one line. 

j . Maximum size of a BASIC-8 program is about 300 lines, depending on the number of variables, 
number and size of arrays, and number of nested subroutines and FOR-NEXT loops. 

3.4 FOCAL 

FOCAL (Formulating On-line Calculations in Algebraic Language) is an on-line, conversational, service pro- 
gram for the PDP-8 family of computers, designed to help scientists, engineers, and students solve numerical 
problems. The language consists of short imperative English statements which are relatively easy to learn. It 
is used for simulating mathematical models, for curve plotting, for handling sets of simultaneous equations, and 
many other kinds of problems. 

For a detailed introduction to the FOCAL programming language, consult the FOCAL Programming Manual 
(Order No. DEC-08-AJAD-D). 

To call FOCAL, type: 

.R FOCAL 

FOCAL enters its initial dialogue, and asks if its extended functions are to be retained. The extended functions 
are exponential, sine, cosine, arctangent, and logarithm. If the FOCAL program to be run uses any of these 
functions, the user responds YES. If not, the user responds NO to free more space for the user program. Without 
the extended functions, there is room for approximately 1800 characters of program. If the extended functions 
are retained, there is room for approximately 1100 characters. 


3.4.1 FOCAL Command and Operation Summary 


Table 3-3 


FOCAL Command and Operation Summary 


Command 

Abbreviation 

Example of Form 

Explanation 

ASK 

A 

ASK X, Y, Z 

FOCAL types a colon for each 
variable; the user types a value 
to define each variable. 

COMMENT 

C 

COMMENT 

If a line begins with the letter C, 
the remainder of the line will be 




ignored , 

CONTINUE 

C 

C 

Dummy lines. 
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Table 3-3 (Cont) 

FOCAL Command and Operation Summary 


Command 

Abbreviation 

Example of Form 

Explanation 

DO 

D 

DO 4.1 

Execute line 4.1; return to com- 
mand following DO command. 



DO 4.0 

Execute all group 4 lines; return 



DO ALL 

to command following DO com- 
mand, or when a RETURN is en- 
countered . 

ERASE 

E 

ERASE 

Erases the symbol table. 



ERASE 2.0 

Erases all group 2 lines. 



ERASE 2.1 

Deletes line 2.1. 



ERASE ALL 

Deletes all user input. 

FOR 

F 

FOR i=x,y,z; (commands) 

Where the command following is 
executed at each new value. 




x=initial value of i 




y=value added to i until i is 
greater than z . 

GO 

G 

GO 

Starts indirect program at lowest 
numbered line number. 

GO? 

G? 

GO? 

Starts at lowest numbered line 
number and traces entire indirect 
program until another ? is en- 
countered, until an error is en- 
countered, or until completion of 
program . 

GOTO 

G 

GOTO 3.4 

Starts indirect program (transfers 
control to line 3.4). Must have 




argument . 

IF 

I 

IF (X)Ln, Ln, Ln 

Where X is a defined identifier. 



IF (X)Ln, Ln; (commands) 

a value, or an expression, 
followed by three line numbers. 



IF (X)Ln; (commands) 

If X is less than zero, control is 
transferred to the first line num- 
ber. 




If X is equal to zero, control is 
to the second line number. 




If X is greater than zero, control 
is to the third line number. 

MODIFY 

M 

MODIFY 1.15 

Enables editing of any character 
on line 1.15 (see below). 

QUIT 

Q 

QUIT 

Returns control to the user. 

RETURN 

R 

RETURN 

Terminates DO subroutines, re- 
turning to the original sequence. 
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Table 3-3 (Cent) 

FOCAL Command and Operation Summary 


Command 

Abbreviation 

Example of Form 

Explanation 

SET 

S 

SET A=5/B*C; 

Defines identifiers in the symbol 
table . 

TYPE 

T 

TYPE A+B-C; 

Evaluates expression and types out 
= and result in current output 
format . 



TYPE A-B, C/E; 

Computes and types each ex- 
pression separated by commas. 



TYPE "TEXT STRING" 

Types text. May be followed by 
! to generate a carriage return 
and line feed, or ^ to generate 
a carriage return. 

WRITE 

W 

WRITE 

WRITE ALL 

FOCAL types out the entire in- 
direct program. 



WRITE 1 .0 

FOCAL types out all group 1 
lines. 



WRITE 1 . 1 

FOCAL types out line 1.1. 


3.4.2 FOCAL Operations 

The following is o description of symbols used in FOCAL operation. 

Symbol 

To set output format, TYPE %x.y 

TYPE %6.3, 123.456 
TYPE % 

To type symbol table, TYPE $ 


Explanation 


Where x is the total number of 
digits, and y is the number of 
digits to the right of the decimal 
point. 

FOCAL types: =tl23.456 

Resets output format to floating 
point. 

Other statements may not follow 
on this line. 


After a MODIFY command, the user types a search character, and FOCAL types out the contents of that line 
until the search character is typed. The user may then perform any of the following operations. 

a. Type in new characters. FOCAL will add these to the line at the point of insertion. 

b. Type a CTRL/L. FOCAL will proceed to the next occurrence of the search character. 

c. Type a CTRL/BELL. After this, the user may change the search character. 

d. Type RUBOUT. This deletes characters to the left, one character for each time the user 
strikes the RUBOUT key. 
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e. Type . Deletes the line over to the left margin, but not the line number. 

f . Type RETURN. Terminates the line, deleting characters over to the right margin. 

g. Type LINE FEED. Saves the remainder of the line from the point at which LINE FEED 
is typed over to the right margin. 

3.4.3 Mathematical Functions 


A listing of mathematical functions follows: 


Function 

Symbol 

Interpretation 

Square Root 

FSQT(x) 

where x is a positive number or expression greater than 
zero. 

Absolute Value 

FABS(x) 

FOCAL ignores the sign of x. 

Sign Part 

FSGN(x) 

FOCAL evaluates the sign part only, with 1 .OCXX) as 
integer. 

Integer Part 

FITR(x) 

FOCAL operates on the integer part of x, ignoring 
any fractional part. 

Random Number 
Generator 

FRAN(x) 

FOCAL generates a random number. The value of x is 
Ignored. 

^Exponential 

Function (e’^) 

FEXP(x) 

FOCAL generates e to the power x. (2.71828^) 

^Sine 

FSIN(x) 

FOCAL generates the sine of x in radians. 

^Cosine 

FCOS(x) 

FOCAL generates the cosine of x in radians. 

^Arc Tangent 

FATN(x) 

FOCAL generates the arc tangent of x in radians. 

logarithm 

FLOG(x) 

FOCAL generates log (x). 

e 


3.4.4 Control Characters 


Control characters and their explanation follows: 


% 

! 

Output format delimiter 
Carriage return and line feed 


# 

Carriage return 


$ 

Type symbol table contents 


( ) 

Parentheses 


[ ] 

Square brackets / 

(mathematics) 

<> 

Angle brackets ^ 


II It 

Quotation marks 

(text string) 

? ? 

Question marks 

(trace feature) 

* 

Asterisk 

(high-speed reader input) 


^These are known as extended functions. 
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(nonprinting) 


SPACE key (names) 

RETURN key (lines) 

ALT MODE key (with ASK statement) 
Comma (expressions) 

Semicolon (commands and statements) 


3.4.5 Reading FOCAL Paper Tapes 

To ensure that FOCAL paper tapes are read without error, they should be read silently. To do this, type 
(CTRL/B) followed by UNDUPLEX just prior to reading the tape in. This Monitor command suppresses the print- 
ing of the program as it is read. As each line is read, o line feed and FOCAL's asterisk are typed, indicating 
that the line is properly stored. After the tape has been completely read, type tB DUPLEX to restore FOCAL to 
its normal mode. An example is shown below: 

♦ERPSE ALL 
* t BUN DUPLEX 


* 

* 

* 

* 

* 

* 

* 

*fBDUPLEX 


♦WRITE ALL 
C-FOCAL^ 1 969 

01.05 C PROCRAK TO CALCULATE THE HYPOTENUSE OF A 

01.06 C RIGHT TRIANGLE GIVEN THE TWO SIDES 
01.10 ASK "SIDES OF TRIANGLE ARE” A. B 
01.20 SET C=FSQT(At 2+B r2 ) 

01.30 TYPE "HYPCTENUSE IS" C, ! 

01.40 GOTO 1.1 
* 


3.4.6 FOCAL Error Messages 


Code 

Explanation 

900.00 

Manual start given from console. 

900.00 

Interrupt from keyboard via CTRL/C . 

901.40 

Illegal step or line number used. 

901.78 

Group number is too large. 

901.96 

Double periods found in a line number. 

901.:5 

Line number is too large. 

901., -4 

Group zero is an illegal line number. 

902.32 

Nonexistent group referenced by DO. 

902.52 

Nonexistent line referenced by DO. 
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Code 

Explanation 

?02.79 

Storage was filled by push-down list. 

703.05 

Nonexistent line used after GOTO or IF. 

703.28 

Illegal command used. 

704.39 

Left of = in error in FOR or SET. 

704.52 

Excess right terminators encountered. 

704.60 

Illegal terminator in FOR command. 

704. :3 

Missing argument in display command. 

705.48 

Bad argument to MODIFY. 

706.06 

Illegal use of function or number. 

706.54 

Storage is filled by variables. 

707.22 

Operator missing in expression or double E. 

707.38 

No operator used before parenthesis . 

707. :9 

No argument given after function call . 

707. ;6 

Illegal function name or double operators. 

708.47 

Parentheses do not match. 

709.11 

Bad argument in ERASE. 

710. :5 

Storage was filled by text. 

711.35 

Input buffer has overflowed . 

720.34 

Logarithm of zero requested. 

723.36 

Literal number is too large. 

726.99 

Exponent is too large or negative. 

728.73 

Division by zero requested . 

730.05 

Imaginary square roots required. 

731. <7 

Illegal character, unavailable command, or unavailable function used. 
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CHAPTER 4 
FORTRAN-D COMPILER 


4. 1 INTRODUCTION TO TSS/8 FORTRAN 

FORTRAN-D compiles and runs programs written in the PDP-8 version of FORTRAN. Programs (usually created 
and stored with the Symbolic Editor) are compiled in a single pass and executed (automatically) immediately 
following compilation. The PDP-8 FORTRAN Manual (Order No. DEC-08-AFCO-D) provides exact instructions 
for writing programs in FORTRAN. 

4.2 CALLING AND USING FORTRAN-D 
To use FORTRAN-D, type; 

. R FORT 

FORTRAN requests the name of the Input file, i.e., the file containing the FORTRAN program to be compiled 
and run. The user responds with the file name, then strikes the RETURN key. FORTRAN then requests the 
name of an output file in which to store the compiled version of the program. For normal usage, just the 
RETURN key need by typed. FORTRAN places the compiled code in a file of its own, then proceeds to run the 
program . 

If a file name is entered for output, FORTRAN creates a permanent file in which the compiled binary program 
is saved. It is then possible to rerun this program without recompiling it. To run an already compiled program, 
call the FORTRAN operating system directly by typing: 

.R FOSL 

FOSL requests the name of an input file. Enter the name of the file containing the compiled binary. 

Examples: 


•R FORT 

IMPUT :MTRIX 
OUTPUT : 
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FORTRAN compiles and executes the program MTRIX but does not save the compiled binary. 

•R FORT 

IMPUT:MTRIX 

OUTPUTiBKTRIX 

FORTRAN compiles and executes the program MTRIX and then leaves the compiled binary in the file named 
BMTRIX. 


•R FOSL 
INPUTiBXTRIX 

The FORTRAN binary program BMTRIX is executed without first being compiled. 

NOTE 

All FORTRAN programs return to the Monitor when 
they have completed execution. 


4.3 FORTRAN l/O 

Differing versions of PDP-8 FORTRAN offer slightly different features. TSS/8 FORTRAN-D differs in the way it 
is called into use (described above), and in its more powerful l/O capability (described below). FORTRAN-D 
allows three data formats: 

I Integer format 

E Exponential format 

A Alpha format, the ASCII value of a character is stored as an integer value. 

The standard device for READ and WRITE statements is the Teletype, which is assigned device code I . Because 
the Teletype is so frequently used, FORTRAN-D includes two special input/output instructions, ACCEPT and 
TYPE. These instructions imply use of the Teletype; therefore, the device code need not be specified. ACCEPT 
is especially convenient if data is to be entered at the keyboard because this instruction automatically supplies 
a line feed when the RETURN key is typed. Also, the user can correct an erroneously typed value by striking 
the RUBOUT key . 

A FORTRAN-D program can also utilize the high-speed reader and punch for l/O. These devices are assigned 
code 2. Because the high-speed reader and punch are shared by all TSS/8 users, it is necessary to assign them 
if they are to be used. Assign the appropriate devices and mount tapes in the reader before running 
FORTRAN-D. When running several FORTRAN-D programs, reassign the devices before each run. 
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TSS/8 FORTRAN also allows programs to read and write data files on the disk. These data files are completely 
separate from the program files. Data files are read and written by standard READ and WRITE statements within 
the FORTRAN-D program. The device code for the disk is 3. Because programs using the disk are treated 
differently by FORT (the FORTRAN-D compiler), it is necessary to identify programs which use the disk. These 
programs are identified by a DEFINE DISK statement as the first statement in any such FORTRAN-D program in- 
cluding a READ or WRITE statement with device code 3. 

Just as FORT itself must ask for the name of its input and output files, so must a FORTRAN program ask for the 
names of its disk files. FORTRAN-D programs do this by typing INPUT: and OUTPUT; a second time. The user 
responds by typing the name of the files to be read or written by the program. FORTRAN-D asks for both input 
and output for all programs which include a DEFINE DISK statement. If only input (or output) is to be used, the 
user responds to the other by striking the RETURN key. 

The following program is an example of a FORTRAN-D program which utilizes the disk for data storage. The 
program reads an already existing file (DATA1) of 10 values from the disk and writes their square roots into a 
new file (DATA2). 


4.4 EXAMPLES OF FORTRAN PROGRAMS 
Example 1: 


C FORTRAM PFOCRAK TO READ 10 VALUES FROM A DISK FILE, 

C C0t<PUTE THEIR SQUARES, AND WRITE THE SQUARES OUT TO 

C A SECOND DISK FILE. 

C 

DEFINE DISK 
DIMENSION AC 10) 

C 

DO 20 1=1,10 
READ 3, 10, AC I ) 

10 FORMAT CE) 

20 CONTINUE 

C 

DO 30 1=1,10 
A C I )=AC I )**2 
30 CONTINUE 

C 

DO 40 1=1,10 
WRITE 3, 10, AC I ) 

40 CONTINUE 

C 

STOP 

END 


•R FORT 

INPUT: SQUARE 
OUTPUT : 
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INPUT : DATAl 
OUTPUT: DATA2 


tBS 


Example 2: 


.R EDIT 

INPUT:MTRIX* 
OUTPUT : 

R 

L 


C MATRIX MULTIPLIER 

DIMENSION A(36)> B(36)> 
TYPE 200 
TYPE 201 
READ 1,1,1 

1 FORMAT ( I ) 

TYPE 202 

DO 10 M=1 , I 
DO 10 N=1,I 
INDX=M+I*(M-1 ) 

READ 1,2,A(INDX) 

2 FORMAT (E) 

10 CONTINUE 

TYPE 15 

15 FORMAT (/) 

TYPE 202 
DO 20 M=1 , I 
DO 20 M=1 , I 
INDX=M+I*(M-1 ) 

READ 1,2,B(INDX) 

C ( INDX )=0 

20 CONTINUE 

DO 30 M=1,I 
DO 30 N=1,I 
DO 30 K=1,I 
IC = N+I*(M-1 ) 

IA=M+I*(K-1 ) 

IB = K+I*(N-1 ) 
C(IC)=C(IC)+A(IA)*B(IB) 
30 CONTINUE 

TYPE 1 5 
DO 40 M=1,I 
TYPE 21 
DO 40 N=1 , I 
INDX=N+I*(M-1 ) 

TYPE 2, C(INDX) 

40 CONTINUE 

21 FORMAT C/) 

TYPE 1 5 


C(36) 
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200 
201 
20 2 


FORI^AT C/^ "MATRIX MULTIPLIER’S/) 
FORMAT ("DIMEMSIOM IS:") 

FORMAT C/VENTER MATRIX’S/) 

END 


TBS 


.R FORT 


INPUT:MTRIX* 
OUTPUT : 


MATRIX MULTIPLIER 
DIMENSION IS:3 
ENTER MATRIX 
12 23 34 
11 21 13 
10 20 30 


ENTER MATRIX 
1.2 1.2 3.1 
.01 121 12 . 
Ill 1.2 343 

0 . 378863E+4 
0 . 1 45641 E+4 
0 . 33421 9E+4 


0 .283820E+4 
0.256979E+4 
0 . 2A6800E+A 


0.11 9751 E+5 
0 .474510E+4 
0. 105610E+5 


TBS 


4.5 SUMMARY OF FORTRAN-D STATEMENTS 


Table 4-1 

Summary of FORTRAN-D Statements 


Statement and Form 

Explanation 

Arithmetic Statements 


V = e 

V is a variable (possibly subscripted); e is an expression. 

Control Statements 


GOTOn 

n is a statement number. 

GO TO (n^ 

n, , . . . ,n are statement numbers; i is a nonsubscripted 
integer variable. 

IF (e) n^,n 2 ,n 2 

e is an expression; n^ are statement numbers. 

DO n i=k^ ,k 2 ,l <2 

n is the statement number of a CONTINUE; is is an in- 
teger variable; k^ are integers or nonsubscripted 

interger variables. 

CONTINUE 

Proceed 

PAUSE 

Temporarily suspend execution. 
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Table 4-1 (Cont) 

Summary of FORTRAN-D Statements 


Statement and Form 

Explanation 

STOP 

Terminate execution. 

END 

Terminate compilation; last statement in program. 

Specification statements 


DIMENSION v^(n^),V2(n2),. . . ,v^(n^) 

v,,...,v ore variable names; n,, — ,n are integers. 
In In 

DEFINE device 

Device is DISK or TAPE, system I/O device. 

FORMAT (s ,s_,...,s ) 

1 z n 

s is a data field specification. 

COMMENT 

Designated by C as first character on line. 

Input/Output Statements 


ACCEPT f,list 

f is a FORMAT statement number; list is a list of 
variables. 

TYPE f,list 

f is a FORMAT statement number; list is a list of 
variables . 

READ u,f,list 

u is an integer, representing device from which data 
is to be read . 

f is a FORMAT statement number; list is a list of 
variables. 

WRITE u,f,list 

u is an integer, representing device onto which data 
will be written. 

f is a FORMAT statement number; list is a list of 
variables. 


4.6 FORTRAN-D COMPILER SYSTEMS DIAGNOSTICS 

Table 4-2 

FORTRAN-D Compiler Systems Diagnostics 


Error 

Code 

Explanation 

0240 

System file error. One of the FORTRAN components cannot be found or the 
disk is full, preventing FORTRAN from proceeding. Try recalling FORT. 

3100 

Illegal operator on compiler stack ^ 

3417 

Pre-precedence error^ 

6145 

Could not find FOSL on system device; if the error occurs, it may be necessary 
to reload FORT and FOSL. 

6223 

Error while loading .FT. 


Error may be due to a compiler error or a machine malfunction. 
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Table 4-2 (Cent) 

FORTRAN-D Compiler Systems Diagnostics 


Error 

Code 

Explanation 

6226 

Some as above 

6257 

Same as above 

6724 

No END statement on source device 

6746 

Some as above 

7114 

Same as above 



4.7 FORTRAN-D COMPILER COMPILATION DIAGNOSTICS 

Table 4-3 

FORTRAN-D Compiler Compilation Diagnostics 


Error 

Code 

Explanation 

00 

Mixed mode arithmetic expression 

01 

Missing variable or constant in arithmetic expression 

03 

Comma was found in an arithmetic expression 

04 

Too many operators in this expression 

05 

Function argument is in fixed-point mode 

06 

Floating-point variable used as a subscript 

07 

Too many variable names in this program 

10 

Program too large, core storage exceeded 

11 

Unbalanced right and left parentheses 

12 

Illegal character found in this statement 

13 

Compiler could not identify this statement 

14 

More than one statement with same statement number 

15 

Subscripted variable did not appear in a DIMENSION statement 

16 

Statement too long to process 

17 

Floating-point operand should have been fixed-point 

20 

Undefined statement number 

21 

Too many numbered statements in this program 

22 

Too many parentheses in this statement 

23 

Too many statements have been referenced before they appear in the program 

25 

DEFINE statement was preceded by some executable statement 

26 

Statement does not begin with a space, tab, C, or number 












4.8 FORTRAN-D OPERATING SYSTEM DIAGNOSTICS 


Table 4-4 

FORTRAN-D Operating System Diagnostics 


Error 

Code 

Explanation 

01 

Checksum error on FORTRAN binary input 

02 

Illegal origin or data address on FORTRAN binary input 

04 

Disk input-output error ^ 

05 

High-speed reader error 

06 

Illegal FORTRAN binary input device 

11 

Attempt to divide by zero 

12 

Floating-point input data conversion error 

13 

Illegal op code 

14 

Disk input-output error ^ 

15 

Non-FORAAAT statement used as a FORMAT 

16 

Illegal FORMAT specification 

17 

Floating-point number larger than 2047 

20 

Square root ol o negative number 

21 

Exponential negative number 

22 

Logarithm of a number less than or equal to zero 

40 

Illegal device code used in READ or WRITE statement 

41 

System device full, could rx>t complete a WRITE statement 

76 

Stack underflow error 

77 

+ + 

Stack overflow error 

^May be caused by machine malfunction or operating system error. 

^^May be caused by source progtom or looding error; to correct, do the following in descending 
order. 

a. Use Diagnose to determine where the error occurred. 

b 

>. Recompile the source program. 

e 

Examine source program (in particular the arithmetic statements and subscripted 
variables). 


4-8 









CHAPTER 5 
PAL-D ASSEMBLER 


5. 1 INTRODUCTION TO PAL-D 

The TSS/8 Assembly System is composed of the PAL-D Symbolic Assembler, LOADER, and ODT. The PAL-D 
Assembler is used to translate the user's source program into an object program binary or machine code). 
LOADER is used to transfer the user's object program from the disk into core for debugging or execution. ODT 
(Octal Debuggirtg Technique) is used to dyrumically debug the object program which has been loaded into core 
using LOADER. 

The PAL-D Assembler is fully documented in the PDP-8 PAL-D Assembler, Programmer's Reference Manual 
(Order No, DEC-D8-ASAB-D), and its operation under TSS/8 is covered in an appendix in that document. 
PAL-D source programs are usually written on-line usiitg the EDIT program, which stores them in disk files. The 
Assembler checks for assembly language syntax errors and for undefined user symbols but does not check for 
logic errors. To call the PAL-D Assembler, type: 

,R PALD 

PAL-D responds by requesting INPUT ; Type and enter the name of the source program or programs to be 
assembled . A maximum of three files con be assembled together. PAL-D then requests OUTPUT; Type in the 
name of the new file in which PAL-D will store the assembled program in executable binary form. PAL-D then 
requests OPTION: For a normal assembly, strike the RETURN key. If an assembly listing is not desired, respond 
to OPTION: with N. 

PAL-D then proceeds to assemble the program: ony errors in the program ore iiKlicated; the program symbol 
table is printed; and finally, an assembly listing of the source program is printed. When the listing is completed 
and the assembly finished, control is returned to TSS/8 Monitor. 

5.2 TSS/^ PAL-D 

Because of the necessary hardware changes made for the Time-Shared System, PAL-D has been revised in the 
following ways: 
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a. PAL-D, under TSS/8, allows 245 (decimal) user symbols in addition to the permanent symbols (listed 
in section 5.4). All symbols reside in locations 5200 through 7777. The permanent symbol table has 
been revised to include all instructions peculiar to the Time-Sharing System. 

b. A CTRL/C (tC) from the Teletype terminates the assembly, and halts PAL-D, sending the user back 
to the TSS/8 Monitor. 


5.3 EXAMPLE OF A PAL-D PROGRAM 


•R PALE 


IMPUT:TYPE2 

0UTPUT:BIM2 

OPTION’: 


COUNT 0A15 

CRLF 0A17 

LCCP 0^0 6 

OUT 0A25 

REG 0A16 

START 0A00 




/PROGRAM TO 

TYPE OUT 



’*'0400 



0400 

7200 

START, 

CLA 


0401 

4217 


JMS 

CRLF 

040 2 

1 377 


TAD 

(-12) 

040 3 

3215 


DCA 

COUNT 

0404 

1 376 


TAD 

(260 ) 

040 5 

3216 


DCA 

REG 

0406 

1216 

LOOP, 

TAD 

REG 

040 7 

4225 


JMS 

OUT 

0410 

2216 


ISZ 

REG 

041 1 

221 5 


ISZ 

COUNT 

0412 

5206 


JMP 

LOOP 

0413 

421 7 


JMS 

CRLF 

0414 

7402 


HLT 


041 5 

0000 

COUNT, 

0 


041 6 

0000 

REG, 

0 


041 7 

0000 

CRLF, 

0 


0420 

1 375 


TAD 

(215) 

0421 

4225 


JMS 

OUT 

0422 

1 374 


TAD 

(212) 

0423 

4225 


JMS 

OUT 

0424 

561 7 


JMP 

I CRLF 

0425 

0000 

OUT, 

0 


0426 

6046 


TLS 


0427 

60 41 


TSF 


0430 

5227 


JMP 

.-1 

0431 

7200 


CLA 


0432 

5625 


JMP 

I OUT 

0574 

0212 




0575 

0215 




0576 

0260 




0577 

fBS 

7766 





”0123456789” 


/ASCII CODE FOR ZERO (0) 


/ASCII FOR CARRIAGE RETURN 
/LINE FEED 
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5.4 SYMBOL LIST FOR TSS/8 


Table 5-1 

Symbol List for TSS/8 


Mnemonic 

Code 

Operation 


i 

MEMORY REFERENCE INSTRUCTIONS 

AND 

0000 

Logical AND 

TAD 

1000 

Twos complement add 

ISZ 

2000 

Increment & skip if zero 

DCA 

3000 

Deposit & clear AC 

JMS 

4000 

Jump to subroutine 

JMP 

5000 

Jump 



GROUP 1 OPERATE MICROINSTRUCTIONS 

NOP 

7000 

No operation 

lAC 

7001 

Increment AC 

RAL 

7004 

Rotate AC & link left one 

RTL 

7006 

Rotate AC & link left two 

RAR 

7010 

Rotate AC & link right one 

RTR 

7012 

Rotate AC & link right two 

CML 

7020 

Complement link 

CMA 

7040 

Complement AC 

CLL 

7100 

Clear link 

CLA 

7200 

Clear AC 



GROUP 2 OPERATE MICROINSTRUCTIONS 

HLT 

7402 

Halts the computer 

OST 

7404 

Inclusive OR switch register with AC 

SKP 

7410 

Skip unconditionally 

SNL 

7420 

Skip on nonzero link 

SZL 

7430 

Skip on zero link 

SZA 

7440 

Skip on zero AC 

SNA 

7450 

Skip on nonzero AC 

SMA 

7500 

Skip on minus AC 

SPA 

7510 

Skip on plus AC (zero is positive) 



COMBINED OPERATE MICROINSTRUCTIONS 

1 

CIA 

7041 

Complement & increment AC 

STL 

7120 

Set link to 1 

GLK 

7204 

Get link (put link in AC, bit 11) 

STA 

7240 

Set AC=-1 

LAS 

7604 

Load AC with switch register 


Event Time 


1 

3 


2 

I 

I 


4 

3 
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Table 5-1 (Cont) 
Symbol List for TSS/8 


PSEUDO-OPERATORS 


DECIMAL 

OCTAL 

EXPUNGE 

PAGE 

FIELD 

PAUSE 

FIXTAB 

TEXT 

I 

XLIST 


Z 


Mnemonic Code Operofion Event Time 


lOT MICROINSTRUCTIONS 


Program Interrupt 

lOT 

6000 

(See Time-Sharing System User's Guide 
DEC-T8-MRFB-D) 


Keyboard Reader 




KSF 

6031 

Skip if keyboard/reader flog = 1 

1 

KCC 

6032 

Clear AC & keyboard/reader flag 

2 

KRS 

6034 

Read keyboard/reader buffer 

3 

KRB 

6036 

Clear AC & read keyboard buffer, 

& clear keyboard flag 

2,3 

KSB 

6400 

Set keyboard break 


SBC 

6401 

Set buffer control flags 


KSR 

6030 

Read keyboard string 


Tel epri nter/j*unch 




TSF 

6041 

Skip if teleprinter/punch flag = 1 

1 

TCF 

6042 

Clear teleprinter/punch flag 

2 

TPC 

6044 

Load teleprinter/punch buffer. 

Select & print 

3 

TLS 

6046 

Load teleprinter/punch buffer. 

Select & print, and clear 

Teleprinter/punch flag 

2,3 

SaS 

6040 

Send a strirtg 


High-Speed Reader (Typ 

e PC02) 



RSF 

6011 

Skip if reader flag = 1 

1 

RRB 

6012 

Read reader buffer & clear flag 

2 

RFC 

6014 

Clear flag & buffer & fetch character 

3 

RRS 

6010 

Read reader string 


High-Speed Punch (Type 

> PC03) 



PSF 

6021 

Skip if punch flag = 1 

1 

PCF 

6022 

Clear flag & buffer 

2 

PPC 

6024 

Load buffer & punch character 

3 

PLS 

6026 

Clear flag & buffer, load & punch 

2,3 

PST 

6020 

Punch string 
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Table 5-1 (Cent) 

Symbol List forTSS/8 

Mnemonic Code Operation Event Time 


DECtape Transport (Type TU55) and Control (Type TCOl) 


DTXA 

6764 

Load status register A 

DTSF 

6771 

Skip on flogs 

DTRB 

6772 

Read status register B 

Program Control 

URT 

6411 

User run time 

TOD 

6412 

Time of day 

RCR 

6413 

Return clock rate 

DATE 

6414 

Date 

STM 

6415 

Quantum synchronization 

TSS 

6420 

Skip on TSS/8 

USE 

6421 

User 

SSW 

6430 

Set switch register 

CKS 

6200 

Check status 

ASD 

6A40 

Assign device 

REL 

6442 

Release device 

DUP 

6402 

Duplex 

CON 

6422 

Console 

File Control 

WHO 

6616 

Who 

SIZE 

6614 

Segment size 

RFILE 

6603 

Read file 

WFILE 

6605 

Write file 

ACT 

6617 

Account number 

REN 

6600 

Rename file 

OPEN 

6601 

Open file 

CLOS 

6602 

Close file 

PROT 

6604 

Protect file 

CRF 

6610 

Create file 

EXT 

6611 

Extend file 

RED 

6612 

Reduce file 

FINF 

6613 

File information 
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5.5 ERROR DIAGNOSTICS 


Table 5-2 

PAL-D Error Diagnostics 


Error 

Code 

Explanation 

BE 

Two PAL-D Internal tables have overlapped - This situation can usually be 
corrected by decreasing the level of literal nesting or number of current 
page literals used prior to this point on the page. 

DE 

System device error - An error was detected when trying to read or write onto 
the system device; after three failures, control is returned to the Monitor. 

DF 

Systems device full - The capacity of the systems device has been ex- 
ceeded; assembly is terminated and control Is returned to the Monitor. 

IC 

Illegal character - An illegal character was encountered other than in 
a comment or TEXT field; the character is ignored and the assembly 
continued . 

ID 

Illegal redefinition of a symbol - An attempt was made to give a pre- 
viously defined symbol a new value by means other than the equal sign; 
the symbol was not redefined. 

IE 

Illegal equals - An equal sign was used in the wrong context. 

Examples: 

TAD A + = B the expression to the left of the equal sign is not 
a single symbol or, the expression to the right of 

A +B=C the equal sign was not previously defined 

II 

Illegal indirect - An off-page reference was made; a link could not be 
generated because the indirect bit was already set. 

ND 

The program terminator, $, is missing. 

PE 

Current nonzero page exceeded - An attempt was made to 

a. override a literal with an instruction, or 

b. override an instruction with a literal; this can be corrected by 

(1) decreasing the number of literals on the page or 

(2) decreasing the number of instructions on the page. 

PH 

Phase error - PAL-D has received input files in an incorrect order; 
assembly is terminated and control is returned to the Monitor. 

SE 

Symbol table exceeded - Assembly is terminated and control is returned 
to the Monitor; the symbol table may be expanded to contain up to 1184 
user symbols by saving a file named .SYM on the system device. 

US 

Undefined symbol - A symbol has been processed during pass 2 that was 
not defined before the end of pass 1 . 

ZE 

Page 0 exceeded - Same as PE except with reference to page 0. 
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CHAPTER 6 
UTILITY PROGRAMS 


6.1 EDIT 

TSS/8 Editor provides the user with a powerful tool for creating and modifying source files on-line. Its precise 
capabilities and commands are detailed in the PDP-8 Symbolic Editor Programming Manual (Order No. 
DEC-08-ESAB-D). EDIT allows the user to delete, insert, change, and append lines of text; and then obtain 
a clean listirtg of the updated file. EDIT also contains commands for searching the file for a given character. 

EDIT considers a file to be divided into logical units, called pages. A page of text is generally 50-60 lines 
long, and hence corresponds to a physical page of program listing. A FORTRAN-D program is generally 1-3 
pages in length; a program prepared for PAL-D may be several pages in length. EDIT operates on one page of 
text at a time, allowing the user to relate his editing to the physical pages of his listing. EDIT reads a page 
of text from the input file into its internal buffer where the page becomes available for editing. When a 
page has been completely updated, it is written onto the output file and the next page of the input file is made 
available. EDIT provides several powerful commands for "paging" through the source file quickly and con- 
veniently. 

NOTE 

The end of a page of text is marked by a form feed (CTRL/L) 
character. Form feed is ignored by all TSS/8 language 
processors. 

To call the Editor, tyf)e: 

•R EDIT 

EDIT responds by requesting INPUT: Type and enter the name of the source file to be edited. If a new file 
is to be created using EDIT, there is no input file. In this case, strike the RETURN key. EDIT then requests 
OUTPUT: Type in the name of the new, edited, file to be created. The name of the output file must be different 
from the name of the input file. If EDIT is being called to list the input file, there is no need to create an 
output file; strike the RETURN key. When EDIT sets up its internal files and is ready for a command, it rings 
the bell on the Teletype. 
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For example: 

•R EDIT 
INPUT: VXZOLD 
OUTPUTiXYZNEW 

(Bell rings at this point.) 


6.1.1 Summary of Symbolic Editor Operations 


Table 6-1 

Summary of Symbolic Editor Operations 


Special Characters 

Function 

Carriage Return 
(RETURN Key) 

Text Mode - Enter the line in the text buffer. 

Command Mode - Execute the command. 

Back Arrow ( •^) 

Text Mode - Cancel the entire line of text, continue typing on 
same line. 


Command Mode - Cancel command. Editor issues a ? and 
carriage return/line feed. 

Rubout (\) 

Text Mode - Delete from right to left one character for each rubout 
typed. Does not delete past the beginning of the line. Is not in 
effect during a READ command. 


Command Mode - Same as back arrow. 

Form Feed 

(CTRL/FORM Combination) 

Text Mode - End of inputs return to command mode. 

Period (.) 

Command Mode - Current line counter used os argument alone or in 
combination with + or - and a number (. , .+5L). 

Slash (/) 

Command Mode - Value equal to number of last line in buffer. Used 
as argument (/-5,A)- 

Line Feed ( 1 ) 

Text Mode - Used in SEARCH command to insert a CR/LF combination 
into the line being searched. 

Right Angle Bracket (>) 

Command Mode - List the next line (equivalent to . + 1L). 

Left Angle Bracket (<) 

Command Mode - List the previous line (equivalent to .-IL). 

Equal Sign ( + ) 

Command Mode - Used in conjunction with . and / to ci)tain their 
value ( .=27). 

Tabulation 

(CTRL/TAB Key Combination) 

Text Mode - Produces a tabulation which, on output, is interpreted as 
spaces if bit 1 of the switch register is set to 0, or as a tab character/ 
rubout combination if bit 1 is set to 1. 
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6.1.2 EDIT Ccxnmand Summary 


Table 6-2 

EDIT Command Summary 


Command 

Format(s) 

Meaning 

READ 

R 

Read text from the input file and append to buffer until a form 
feed is encountered. 

APPEND 

A 

Append incoming text from keyboard to any already in buffer until 
a form feed is encountered. 

LIST 

L 

List the entire buffer. 


nL 

List line n. 


m,nL 

List lines m through n inclusive. 

PROCEED 

P 

Output the contents of the buffer to the output file, followed by 
a form feed. 


nP 

Output line n, followed by a form feed. 


m ,nP 

Output lines m through n inclusive followed by a form feed. 

TERMINATE 

T 

Close out the output file and return to TSS/8 Monitor. 

NEXT 

N 

Output the entire buffer and a form feed, kill the buffer and 
read the next page . 


nN 

Repeat the above sequence n times. 

KILL 

K 

Kill the buffer (i.e., delete all text lines). 

DELETE 

nD 

Delete line n of the text. 


m,nD 

Delete lines m through n inclusive. 

INSERT 

I 

Insert before line 1 all the text from the keyboard until a form 
feed is entered. 


nl 

Insert before line n until a form feed is entered. 

CHANGE 

nC 

Delete line n, replace it with any number of lines from the key- 
board until a form feed is entered. 


m,nC 

Delete lines m through n, replace from keyboard as above until 
form feed is entered. 

MOVE 

m,n$kM 

Move lines m through n inclusive to before line k. 

GET 

G 

Get and list the next line beginning with a tag. 

SEARCH 

S 

Search the entire buffer for the character specified (but not echoed) 
after the carriage return. Allow modification when found. TSS/8 
Editor outputs a slash (/) before beginning a SEARCH. 
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Table 6-2 (Cent) 
EDIT Command Summary 


Command 

Format(s) 

Meaning 

SEARCH 

nS 

Search line n, as above, allow modification. 

(Cont) 

m ,nS 

Search lines m through n inclusive, allow modification. 

END 

E 

CXjtput the contents of the buffer. Read in any pages remaining in 
the input file, outputting them to the output file. When everything 
in the input file has been moved to the output file, close it out and 
return to the TSS/8 Monitor. E is equivalent to a sufficient number 
of N's followed by a T command. 

fC 

CTRL/C 

Stop listing and return to Command Mode. 


6.2 LOADER 


TSS/8 LOADER is used to load programs in BIN format From a disk file into the user's core area for execution. 
These files in BIN format can be created by PAL-D in the course of an assembly or they can be loaded from 
paper tape using PIP (see the PIP writeup for special instructions on loading BIN format tapes). 

To call LOADER, type: 

.R LOADER 

LOADER responds by asking for INPUT: Respond by entering the name of the file or files to be loaded. Although 
many System Library FVograms allow multiple input files, the LOADER uses this feature to special advantage. 
Because it loads the files in the order they are typed, LOADER can be used to load patches and overlays. After 
it has requested INPUT, LOADER requests OPTION: For normal operation strike the RETURN key; LOADER is 
able to load into any part of core below 7750. If the program to be loaded is to be debugged, respond to 
OPTION: with D. This will cause ODT to be loaded along with the input files and started. ODT indicates 
that it is ready by printing a second line feed. ODT uses locations 7000 through 7577; and if loaded along 
with a program which uses any of these locations, the result of the load is unpredictable. 

Example 1: Normal Operation 


.R LOADER 

INPUT: MAIN^ PATCHIj PATCH2 
OPTION: 

TBS 
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Example 2: Load ODT with Input File 


•R LOADER 

INPUT;PR0G1 
OPTION: D 

As seen in the first example, LOADER returns control to Monitor when it is finished. The user can then start 
the program by using the Monitor command START. For example, LOADER can be used to load and run the 
short program given as an example in the section on PAL-D (see Chapter 5, Section 5.3). 


•R LOADER 

INPUT: BIN2 

OPTION: 

tBS 

•START A00 


0123456789 

TBS 


NOTE 

The BIN format files loaded by LOADER include a checksum. 
If LOADER detects a checksum error while loading, it types 
"LOAD ERROR" and terminates the load. 


6.3 ODT (Octal Debugging Technique) 

ODT is a powerful octal debugging tool for testing and modifying PDP-8 programs in actual machine language. 
It allows the user to control the execution of his program and, where necessary, make immediate corrections to 
the program without the need to reassemble. 

The complete command repertoire of ODT is documented in the ODT Manual (Order No. DEC-08-COCO-D). 
ODT (on TSS/8) is the high-core version which resides in locations 7000 through 7577. The paper-tape output 
commands of regular ODT are not available in TSS/8 ODT. To call ODT, type: 

•LOAD 2 ODTHI 0 7000 
•START 7000 


If ODT is to be used to debug a program being loaded with LOADER, ODT con be loaded and started directly 
by specifying the Debug (D) option to LOADER. 
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6.3.1 Pl-ogramming Notes 

ODT executes an SRA (Set Restart Address) as part of its initialization process. As a result, typing CTRL/C 
always returns control to ODT. If the program being debugged sets up its own restart address, typing CTRL/C 
transfers control to the new restart address. It is necessary to type IBS followed by START 7000 to force control 
back to ODT. 

Every time ODT regains control, it puts the Teletype in duplex mode. Users debugging programs which do not 
operate in duplex mode, should be aware of this fact. 

ODT saves the state of the delimiter mask, when it regains control via a breakpoint. The state of this mask 
is restored on a Continue (C) command, but not on a GO (G) command. 


6.3.2 ODT Command Summary 


Table 6-3 

ODT Command Summary 


Command 

Meaning 

nnnn/ 

Open register designated by the octal number nrmn. 

/ 

Reopen latest opened register. 

RETURN 

Close previously opened register. 

LINE FEED (I) 

Close register and open the next sequential one for modification. 

Up Arrow (1) 

(SHIFT/N) 

Close register, take contents of that register as a memory reference 
and open it. 

Back Arrow (*-) 
(SHIFT/O) 

Close register open indirectly. 

Illegal Character 

Current line typed by user is ignored, ODT types 7CR/IF . 

nnnnG 

Transfer program control to location nnnn. 

nnnnB 

Establish a breakpoint at location nrmn. 

B 

Remove the breakpoint. 

A 

Open for modification, the register in which the contents of AC were 
stored when the breakpoint was encountered. 

C 

Proceed from a breakpoint. 

nnnnC 

Continue from □ breakpoint and iterate past the breakpoint nnnn times 
before interrupting the user's program at the breakpoint location. 

M 

Open the search mask register, initially set to 7777. It may be changed 
by opening the search mask register and typing the desired value after the 
value typed by ODT, then closing the register. 

I (line feed) 

Close search mask register and open next register immediately following, 
containing the location at which the search begins. It may be changed by 
typing the lower limit after the one typed by ODT, then closing the register. 
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Table 6-3 (Conf) 
ODT Command Summary 


Command 

Meaning 

i (line feed) 

Close lower search register, open next register containing the upper 
search limit initially set to 7000 or 1000 (location of ODT). It may 
be changed by typing the desired upper limit after the one typed by 

ODT and closing the register with a carriage return. 

nnnnW 

Search the portion of core as defined by the upper and lower limits 
for the octal value nnnn. 


6.4 CAT 

TSS/8 Monitor maintains a library of disk files for each user. The System Library Program CAT is used to obtain 
a catalog of the contents of this library. For each file, CAT types the size of the file in units of disk segments. 
The size of a disk segment may vary among installations. Generally, it is 256 (decimal) words of disk storage. 
The protection code for the file is also given. (See the section on the PROTECT Monitor command (Chapter 9) 
for a precise explanation of protection codes.) If the program was created by any of the System Library IVograms, 
it has a protection code of 12, meaning that other users can read the file, but only the owner can change it. 

To call CAT, type: 


• R CAT 


6.4. 1 Example of CAT Usage 


• R CAT 

DISC FILES FOR USER 312 lA NOV 69 


NAME 

SIZE 

PROT 


DATE 

BAS016 

1 

12 

14 

NOV 

69 

BASl 1 6 

1 

12 

1 4 

NOV 

69 

PRIME 

8 

1 2 

14 

NOV 

69 

MATRIX 

3 

1 2 

14 

NOV 

69 

SOLVE 

1 

12 

14 

NOV 

69 

PROG 

1 1 

12 

14 

NOV 

69 

TYPE2 

2 

12 

14 

NOV 

69 

BIN2 

1 

12 

14 

NOV 

69 

TEMP27 

1 5 

12 

14 

NOV 

69 


TOTAL DISC SEGMENTS: 43 
fBS 
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6.5 SYSTAT (System Status) 

It is frequently useful to know the status of the system as a whole; how many users are on-line, where they are, 
what they are doing, etc. The SYSTAT program provides this capability. To call SYSTAT, type: 

•SYSTAT 
•R SYSTAT 

SYSTAT responds by printing on the first line: the version of the TSS/8 Monitor being run, the time, and the 
date. SYSTAT reports the uptime which is the length of time in hours, minutes, and seconds since the system 
was last put on-line. 

SYSTAT lists all on-line users. Each user is identified by his account number. The job number assigned to him 
and the number of the console he is using are indicated, as is the particular System IVogram he is running. The 
exact running state of each user, whether he is actually running (RUN), typing in (KEY) or out (TTY), doing 
input/output on another system device (lO or FIP), or not running (tB), is indicated. The amount of computer 
time used by each user since he logged in is given. 

If more users are on-line than the system has core fields to hold them, the fact that the system is swapping is 
reported. The number of free core blocks used internally by TSS/8 Monitor for Teletype buffering and various 
other purposes is typed out. Then SYSTAT reports any unavailable devices, i.e., devices which are assigned 
to individual users. The job to which they are attached and their status (AS if they are assigned but not active, 
AS+INIT if they are assigned and active) is also indicated. Finally, the number of available segments of disk 
storage is reported. 


6.5. 1 Example of SYSTAT Usage 


•R SYSTAT 


STATUS OF TSS/8. 19 DEC PDP-8 AT 10:27:33 OU 13 OCT 69 
UPTIME 8A:12;33 


JOB 

WHO 

WHERE 

WHAT 

STATE 

1 

5440 

K00 

SYSTAT 

RUN 

2 

10 

K1 4 

COPY 

KEY 

3 

3141 

K1 5 

EDIT 

KEY 

4 

4771 

K1 6 

FORT 

RUN 

5 

4772 

K1 7 

PALD 

TTY 

7 

333 

K0 4 

BASIC 

10 

1 1 

7 

K21 

FOCAL 

RUN 

1 2 

1221 

K0 6 

BASIC 

TB 

14 

2000 

K0 3 

PIP 

RUN 

1 5 

222 

K1 2 

FOCAL 

KEY 

1 7 

5440 

K1 1 

FORT 

TTY 


SWAPPING 28K FREE C0RE=238 


RUNTIME 

01 :00 : 12 
00 : 00:21 
00:00:03 
00:09:42 
00:00:13 
01 :37: 12 
00:00: 57 
00 :03: 51 
00:16:23 
00 : 22 : 1 7 
00:22:19 
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BUSY DEVICES 


DEVICE JOB WHY 


R 1 

P 3 

D0 3 

D5 2 


AS+ lUIT 

AS 

AS 

AS+IMIT 


412 FREE DISC SEGMEMTS 



CHAPTER 7 

PROGRAMS FOR PAPER TAPE AND DECTAPE CONTROL 


7. 1 PIP (Peripheral Interchange Program) 

All TSS/B System Library programs discussed in previous sections operate only on files which are on the disk. 
Disk is a convenient storage medium for many files; however, it may be more useful to keep some programs on 
paper tape. PIP provides a convenient means of transferring files between disk and paper tape, for those users 
who wish to preserve copies of their files off-line. 

7.1.1 PIP Conventions 

PIP may be considered a link between disk file storage and paper-tape devices. To punch out a desired file, 
PIP obtains that file from the disk and punches It on paper tape. Similarly, to load a paper tape, PIP inputs 
the tape from the reader, then outputs It to a disk file. 

The way files are rtamed is important to RP. Files on disk are always named. Paper tapes, on the other hand, 
have no names os far as the system is concerned (although the user can label the physical tape in any manner 
he chooses). Paper tapes never hove file names; therefore, PIP uses the absence of a file name to indicate a 
paper tape (absence of a file name is indicated by striking the RETURN key). 

The way in which INPUT: and OUTPUT: is indicated provides the means for determining the direction of file 
transfer. If PIP is to get its input from the disk, the input is a file name; if the input is from a paper tape no 
file name is given. Similarly, if PIP is to output to the disk, the file name is indicated; if output is to paper 
tape, no name is given. To call PIP, type: 


.R PIP 


7. 1.2 Using PIP to Load a Paper Tape to a Disk File 

To move a paper tope to disk, strike the RETURN key when PIP requests INPUT: Since PIP must output to the 
disk, respond to OUTPUT: by typing a file name. When RP requests OPTION: type T to indicate that the 
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paper tape is being loaded from the Teletype reader. For example: 


.R PIP 
INPUT: 

OUTPUT: FILEl 
0PTI0N:T 


The paper tape, in the low-speed reader, is read in and stored in the system as HLEl . 

7.1.3 Using PIP to Punch Out a Disk File 

To move a disk file onto paper tape, the use of file names is reversed since PIP must input a disk file and output 
it to |X3 per tape. The option remains the same. For example: 

• R PIP 

INPUT:FILE1 

OUTPUT: 

OPTIOW.'T 

The contents of FILEl are then punched out at the Teletype. 

7. 1 .4 Using PIP with the High-Speed Reader and Punch 

PIP can also be used with high-speed paper-tape devices. The format of the INPUT: and OUTPUT: responses 
is the same. However, for the high-speed reader, the option is R and for the punch it is P. 

Since the reader and punch are assignable devices, they are not always available (other users may have one or 
both assigned). Therefore, whenever PIP is given a command which utilizes one of these devices, it checks to 
make sure that the device is available. If it Is, PIP automatically assigns it (thus, it is not necessary to assign 
the device before running PIP). If the device is unavailable, PIP so informs the user. For example: 

INPUT: 

OUTPUT: ABCD 
OPT I ON ;R 


PIP reads the pxaper tape in the high-speed reader and stores it in the system as ABCD. 


INPUT:ABCD 

OUTPUT: 

OPTION:P 


7-2 



PIP punches out’ file ABCD on the high-speed punch. 


mPUT ;ABCD 
OUTPUT; 

OPTIOMtP 

DEVICE MOT AVAILABLE 


The punch is assigned to another user, or there is no punch on the TSS/8 system, or there is one but it is turned 
off. 


7. 1.5 Using PIP to Transfer BIN Format Files 

The examples above work for all ASCII file transfers (except BASIC programs, explained below.) They are also 
valid for punching out BIN format files with either high- or low-speed devices. Loading BIN format tapes, 
however, is a special case. 

BIN format tapes must end with trailer codes. The easiest way to ensure that they do is to cut off the tape near 
the end of the trailer code. Failure to do this (or cutting it off very unevenly) does not prevent PIP from loading 
tape into the disk file. However, later attempts to load the file with LOADER will result in load errors. 

NOTE 

Some TSS/8 installations will not allow any BIN format tapes 
to be loaded from the low-speed reader. 


7.1.6 Moving Disk Files 

PIP can be used to move the contents of one file into another. This is often useful in copying a file from another 
user's library (providing the file is not protected) into your own library. To copy from disk file to disk file, 
specify a file name for both input and output. Reply to OPTION: by striking the RETURN key. For example: 

IMPUT: FOCAL 2 
OUTPUT ;FOCALX 
OPTION; 

PIP gets FOCAL from account number 2's library and moves it into the file FOCALX. 

7.1.7 Deleting Disk Files 

One of the principal reasons for punching out files on paper tape is to free disk space. Once punched out, the 
disk file is no longer needed. PIP offers a convenient means of deleting files, the Delete option; 
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IMPUTrABCD 
OUTPUT: 
OPTION: D 


PIP deletes file ABCD, provided that the file is not protected against being changed. 


7.1.8 Transferring BASlC-8 Files 

BASIC-8 stores its programs in a unique file format. Therefore, it is not possible to load or punch BASIC-8 
files in the usual way. To provide a convenient means of handling BASIC-8 programs, the B option is available 
in PIP. 

The B option is used for both reading and punching BASIC-8 programs. The responses to INPUT: and OUTPUT: 
indicate the direction of the transfer; the high-speed reader or punch is always assumed for the B option. (To 
read or punch tapes at low-speed, use BASIC-8 itself.) 

PIP assumes that any BASIC-8 tapes it loads are clean and error-free. Only tapes actually created by BASIC 
should be loaded with PIP. Tapes created off-line, and thus liable to contain errors, should be loaded low- 
speed by BASIC-8 itself with the TAPE command. 

7.1.9 Transferring SAVE Format Files 

Another special TSS/8 file format is that of the SAVE files, those programs directly executed by TSS/8. (The 
System Library Programs are examples of SAVE format files.) PIP provides the S option, to allow these files 
to be punched on paper tope. SAVE format tapes make sense only to TSS/8 PIP. They cannot be input to any 
other System Program. 

The responses to INPUT: and OUTPUT: indicate the direction of the transfer; the high-speed reader or punch is 
always assumed for the S option. 


NOTE 

SAVE format tapes include a checksum. If PIP detects an incorrect 
read, it prints LOAD ERROR, and terminates the load, repeating 
the request for input. 
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7.1.10 Summary of HP Options 

Option Explanation 

T Transfer a file between the disk and the Teletype reader or punch. The response to 

INPUT; and OUTPUT; indicates the direction of the transfer. 

R Read a tape from the high-speed reader and store it as a disk file. 

P Punch out the contents of a disk file on the high-speed punch. 

D Delete the file specified for input. 

B Transfer a BASIC-fi program file between the disk and the high-speed reader or punch. 

The response to input and output indicates the direction of the transfer. 

S Transfer a SAVE format file between the disk and the high-speed reader or punch. 

The response to INPUT; and OUTPUT; indicates the direction of the transfer. 

7.2 COPY 

Many TSS/8 installations include one or more DECtapes. For these installations, DECtape provides a convenient 
and inexpensive means of file storage. The COPY program is used to transfer files between disk and DECtape. 

7.2.1 Using and Calling COPY 

COPY is the intermediary between disk and DECtape. To write a disk file out to DECtape, COPY inputs the 
file from the disk, then outputs it to the DECtape. To bring a DECtape file onto the disk, COPY inputs from 
the DECtape, then outputs to the disk. 

Files kept on DECtape have file names just as they do on the disk. To avoid confusion, the user must tell COPY 
where the file is to be found. If it is on DECtape, the DECtape designation and the number of the DECtape 
unit must preface the file name. The DECtape number is olways separated from the file name by a colon. Thus 
D1;FILE1 means the file name RLEl on the DECtape which is currently mounted on DECtape unit number one. 
The number of available tape units varies among installations. The maximum is eight, (numbered 0 - 7). If 
a file name is not prefaced by a DECtape number, then this file is assumed to be on the system disk. 

Files stored on DECtape do not have protection codes in the sense that disk files do. They are, however, pro- 
tected against unauthorized access. When a DECtape is not mounted, it is not available to any user. When it 
is mounted, it is available only to the user who has assigned the DECtape unit on which it is mounted. Even 
then it can not be altered unless the DECtape unit is set to WRITE ENABLE. 

Users should be sure to assign a DECtape unit before mounting their tape, and dismount the tape before releasing 
the device. Normally, the DECtape unit to be used should be assigned before calling COPY. 
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•ASSIGN D A 
D A ASSIGNED 
.R COPY 


To call COPY, type: 


•R COPY 


COPY responds by asking which option the user wishes to employ. The COPY options are discussed below. 
7.2.2 Loading Files from DECtape 

To load a file onto the disk from DECtape, use the COPY option. When COPY requests OPTION- respond with 
COPY, or C, or strike the RETURN key (the COPY option is assumed). When COPY requests INPUT- type the 
number of the DECtape unit on which the file can be found (DO, Dl, D2, D3, D4, D5, D6, or D7) followed by 
a colon and the name of the file on the DECtape. When COPY requests OUTPUT- type and enter the name to 
be given to the output file on the disk. COPY then moves the DECtape file onto the disk. (When using COPY, 
it is not mandatory to insert a space between the device designator and the device number.) For example: 

OPTION- COPY 
INPUT - DA;PQR 
OUTPUT - PQR 


If for any reason, COPY cannot find the DECtape file specified for input (the specified DECtape is unavailable 
or nonexistent, or the file name does not exist on that DECtape), COPY prints a ? and repeats the request for 
input. If the disk file specified for output already exists, COPY prints a ? and repeats the request for output. 
COPY does not overwrite an existing file. For example: 


OPTION - C 
INPUT - D9;PQR 
? INPUT - DA:PQRS 
? INPUT - DA:PQR 
OUTPUT - FILEl 
70UTPUT- PQR 
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7.2.3 Saving Disk Files on DECtape 


Saving a disk file on DEQape is very similar to loading one. The option is still COPY. For input, respond with 
the name of the file on the disk. For output, type the DECtape unit number, colon, and the name to be given 
to this file. For example: 

OPTIOM - C 
IMPUT - ABCD 
OUTPUT - D4:ABCD 

If COPY cannot find the file on the disk, or If it is protected, COPY prints a ? and repeats the request for in- 
put. If COPY cannot set up the desired DECtape file (the specified DECtape does not exist or is unavailable, 
or it is not WRITE ENABLED, or a file by that name already exists on the tape) COPY types a ? and repeats the 
request for output. 

7.2.4 Listing Directories 

COPY can be used to list the directory of a device. To list a directory, respond to OPTION-by typing LIST, or 
just L. COPY then asks which device it is to list. To list a DECtape's directory, respond with the device name 
(DO, ...,D7). Do not follow it by a colon. For example: 

OPTION - LIST 
DEVICE - D0 

1298. FREE BLOCKS 

NAME SIZE DATE 

XCOPY 32 6-N0U-69 

XBASIC 66 6-N0U-69 

FOO 66 6-N0V-69 

The unit of DECtape storage is the block, which is 128 (decimal) words. Because the unit of disk storage, the seg- 
ment, is generally 256 words, a file occupies twice as many blocks of DECtape storage as it did segments on the disk. 

COPY can also be used to list the user's disk directory. Use the LIST option, but respond to DEVICE- by 
simply striking the RETURN key. The directory listing is similar to the listing obtained by running the CAT 
program . 

7.2.5 Deleting Files 

COPY can be used to delete files, either on the disk or on a selected DECtape. To delete a file, respond to 
OPTION- by typing DELETE, or just D. Respond to INPUT- by typing the name of the file to be deleted. 
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If the file is on a DECtape, preface the file name with the DECtape unit number and a colon. For example: 


OPTION - DELETE 
IMPUT - D4:ABCD 

If COPY cannot find the file to be deleted, or having found it, cannot delete it (it is a protected disk file or 
a DECtape file on a unit which is not WRITE ENABLED), COPY prints a ? and repeats the request for INPUT-. 

7.2.6 Deleting All Files on a Device 

COPY can be used to delete all existing files on a device. To do so, respond to OPTION- by typing ZERO, 
or just Z. When COPY requests INPUT- respond with the name of the device. To delete all files on the disk, 
strike the RETURN key. The ZERO option should also be used to format a blank DECtape before attempting to 
copy any files onto it. For example: 


OPTION - ZERO 
IMPUT - DA 


or 


OPTION - Z 
INPUT - 


COPY cannot delete files from a DECtape unless it is WRITE ENABLED. It cannot delete disk files which ore 
write protected. 

7.2.7 Summary of COPY Options 


Option 

Explanation 

COPY 

Transfer a file between disk and DECtapi 

LIST 

List a directory. 

DELETE 

Delete a file. 

ZERO 

Delete all files. 
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7.2.8 Example of COPY Usage 


.ASSIGN 

D 5 

D 5 ASSI 

GNED 

.R COPY 


OPTION - 

ZERO 

DEVICE - 

D5 

OPTION - 

LIST 

DEVICE - 

D5 


1-^62. FREE BLOCKS 
NAME SIZE DATE 


OPTION - LIST 
DEVICE - 


DISK FILES FOR USER 5440 ON 13-0CT-69. 

NAME SIZE PROT DATE 

SOLVE 1 12 13-0CT-69 

TOTAL DISK SEGMENTS: 1 

OPTION - COPY 
INPUT - SOLVE 
OUTPUT - D5: SOLVE 


OPTION - DELETE 
INPUT - SOLVE 


OPTION - LIST 
DEVICE - D5 


1460. FREE BLOCKS 

NAME SIZE DATE 

SOLVE 2 13-0CT-69 


7-9 



OPTION - LIST 
DEVICE - 

DISK FILES FOR USER 5440 ON 13-0CT-69 

NAME SIZE PROT DATE 

TOTAL DISK SEGMENTS: 0 

OPTION- COPY 
INPUT- D5: SOLVE 
OUTPUT- ABCD 


OPTION- LIST 
DEVICE- 


DISK FILES FOR USER 5440 ON 13-0CT-69 

NAME SIZE PROT DATE 

ABCD I 12 13-0CT-69 

TOTAL DISK SEGMENTS: 1 

OPTION- tBS 
.RELEASE D 5 
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CHAPTER 8 

ADVANCED MONITOR COMMANDS 


8.1 INTRODUCTION 

Chapter 2 described the fundamental Monitor commands, i.e. , those needed to utilize existing TSS/8 System 
Library Programs. The TSS/8 Monitor also provides powerful commands for users who wish to create their own 
Library Programs. 

To use the System Library Programs described in Chapters 3 through 7, it was not necessary to be familiar with 
the actual machine that runs them, the PDP-8/I. To create new Library Programs for TSS/8, this is necessary 
because they are written in the PDP-8 assembly language. The user codes his programs for a 4K PDP-8, subject 
to the time-sharing conventions discussed in the following chapter. The programs are created with TSS/8 EDIT, 
then assembled by PAL-D and loaded by LOADER. Only at this point are they able to be run by TSS/8. In the 
course of this program development, the same program exists in many formats. The source program is a disk file 
containing ASCII characters in an Editor format. PAL-D reads the file and translates it into a second file, the 
assembled program in BIN format. Neither of these files is capable of being executed directly by TSS/8. The 
BIN format tape must be loaded into core by LOADER before It can actually be executed. 

At this point it is possible to save the program in a file format that is directly executable by TSS/8. Such a file, 
referred to as a SAVE format file, contains an image of the user's core area after the program has been loaded 
by LOADER. These SAVE format files differ from all the files which are created by System Library Programs and 
cannot be executed directly by TSS/8. Thus, it is not possible to save a BASIC program, (for example FILEl, 
while running BASIC) then return to Monitor, type R FILEl, and get meaningful results. The program in FILEl 
must be executed under control of the BASIC language processor. Only SAVE format files can be called into 
execution directly by the R command. All TSS/8 System Library Programs are stored in SAVE format. 


NOTE 

In the following examples, Sn, Cn, and Dn are used to 
stand for alphanumeric strings (such as file names), oc- 
tal numbers, and decimal numbers, respectively. 
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A number of Monitor command conventions are available to make the commands easier to use. First, more 
than one command may be typed on a line. Individual commands are separated by a semi-colon (;). Second, 
only enough characters of a command to uniquely specify it need be typed. Thus, DEPOSIT can be abbreviated 
DE or DEP. 


.LOAD FILEIJ DEP 20 7000; ST 200 


is exactly equivalent to: 


.LOAD FILEl 
•DEPOSIT 20 7000 
•START 200 


These conventions are available for the elementary Monitor commands as well. They are, however, especially 
convenient for the advanced commands. 


8.2 CONTROL OF USER PROGRAMS 

Once a PAL-D program has been loaded by LOADER, several Monitor commands are available for controlling 
its execution. 


Command 


Explanation 


START Cl 


START 

DEPOSIT Cl C2. ..Cn 

EXAMINE Cl 
EXAMINE Cl D1 
WHERE 


Start execution of a user program at location Cl. When a program is started, 
keyboard input is no longer interpreted as commands to Monitor. Input char- 
acters are passed to the running program. START Cl clears the user's AC and 
link . 

Restart execution of a user program where it was interrupted (either by execution 
of an HLT or by fBS typed at the keyboard). When the START command is given, 
the program's state is restored. 

Deposit the octal values C2 to Cn in the locations starting at Cl. DEPOSIT is 
used to make small octal modifications to a user program. No more than 10 
decimal locations can be modified by a single DEPOSIT instruction. 

Print the octal contents of location Cl . 

Print the contents of D1 locations starting at Cl . 

Print the present status of the user program. The user's AC, PC, and LINK are 
printed. If the TSS/8 processor includes the extended arithmetic element, two 
additional registers, the SC and MQ are printed. 


It is possible to give these utility commands while a user program is running. The CTRL/B character (tB) gets 
the attention of the Monitor without stopping program execution. (fB followed by the S command stops the 
program.) fB can be used together with the WHERE command to follow program execution. After executing 
these commands. Monitor does not put the Teletype back into Monitor mode. 
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8.3 DEFINING DISK FILES 


TSS/8 Monitor allows the user to save core images of his program on the disk for future use. However, before 
saving such a core image, the user must define a disk file in which to save it. 

Disk files, like the user's core, are made up of 12-bit words. Unlike the user's core, which is always 4K in size, 
a file can be any size. The unit of disk file storage is the segment; in most installations a segment is 256 (deci- 
mal) words but can be from 128 to 1024 words long. Files are at least one segment long v\4ien created and grow 
by appending additional segments to the end of the file. In defining a file, the user first creates it, then ex- 
tends it to whatever length he needs. To save a whole 4K image on a system with a segment size of 256 (decimal) 
words, a 16 segment file is required. If only part of the contents of the user's core Is to be saved, a correspond- 
ingly smaller file can be used. 

A file can be created at any time. However, to modify or redefine it in any way, the file must be open. Up to 
four files can be open for a user simultaneously. Opening a file connects it to an internal open file number (0, 

1, 2, or 3). Once a file is open, it is referenced by this internal file number rather than by its file name. 

8.3. 1 Creating a Disk File 

CREATE SI Define a one segment area of disk space and associate with 

it the name given in the command line. 

The file name can be one to six alphanumeric characters of which the first must be a letter. Creating a file 
deletes any existing file of the same name, unless that file is write protected. When created, files are always 
one segment in size. A new file is arbitrarily assigned a protection code of 12, meaning that other users may 
access it but only the owner may change it. Until it has been written in, the contents of a newly defined file 
are undefined. 

8.3.2 Opening and Closing a File 

To use a file, it must first be opened. A file can be opened on any of four internal file numbers; 0, 1, 2, or 3. 

OPEN Cl SI Associate the file SI with the internal file number Cl. 

A user can have up to four files open at a time. If a file is open on an internal file number for which a file is 
already open, that file is first closed. For example: 

•CREATE AB 
•OPEN 1 AB 

AB is now an open file and can be referenced as file 1. 
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An open file can be closed at any time by means of the CLOSE command. 

CLOSE Cl Close rhe file presently open on internal file number Cl. 

Once closed, a file cannot be accessed in any way until it Is reopened. It is possible to close more than one 
file with a single command. 

.CLOSE 0123 

8.3.3 Extending, Reducing, and Renaming a Disk File 

When created, a file is one segment long. If a larger file is needed, the original file can be extended. 

EXTEND Cl D1 Extend the file presently open on internal file Cl by D1 

segments . 

Extending a file adds one or more segments to the end of that file. The contents of the old part of the file are 
not changed. Until written in, the contents of the newly added segments are unspecified. 

An existing file may be reduced in size by means of the REDUCE command: 

REDUCE Cl D1 Reduce the file presently open on internal file Cl by D1 

segments. 

Reducing a file deletes the number of segments indicated from the end of the file. The contents of remaining 
segments of the file are unchanged. If a file is reduced to zero segments, or if D1 is greater than the number 
of segments in the file, it is deleted entirely. An example of the creation and deletion of a 4K file: 

.CREATE FOURK 
.OPEM 3 FOURK 
•EXTEND 3 15 
•REDUCE 3 16 

Existing opened files can be renamed^ Renaming a file does not change its contents in any way. 

RENAME Cl SI The file open on internal file number Cl is given the 

new name SI . 

8.3.4 Protection Codes 

The user can protect his files against unauthorized access. He can also specify the extent of access certain 
other users can have to his files. For example, a user's associates can be permitted to look at the data of 
certain files but not permitted to alter that data. 
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When it is created, a file is assigned a protection code of 12. This protection code is defined below and can be 
changed (see Appendix F), but only by the owner of that file. 

PROTECT Cl C2 The file open on internal file number Cl is given the 

protection code C2. 

The protection code is actually a 5-bit mask. Each bit specifies a unique level of protection. (See the 
PROTECT lOT in Chapter 9 for the meaning of each bit.) 

File protection masks (C2) are assigned as follows: 

1 Read protect against users whose project number differs from owner's. 

2 Write protect against users whose project number differs from owner's. 

4 Read protect against users whose project number is same as owner's. 

10 Write protect against users whose project number is same as owner's. 

20 Write protect against owner. To change the program the owner must change 

the protect code. 

Protection codes are determined as the unique sum of any of the above codes. 

Some of the more common protection codes are as follows: 


.PROTECT 1 12 
.PROTECT 1 17 

. PROTECT 1 37 

. PROTECT 1 0 


Allow other users to access the file but not change it. 

Allow only the file owner to read the file. He can also 
change it. 

Allow only the file owner to read the file. He cannot, 
however, change it. (To change it, he must first change 
the protection.) 

Allow other users to access the file and change it. 


Finally, the user can ask what file is open on a given internal file number by means of the F (File information) 
command. 


F Cl Type out the following information about the file presently 

open on internal file Cl: 

a. Account number of file owner. 

b. Name of file. 

c. Protection code. 

d. Size of file in segments (decimal). 

For example: 

.F 1 

0010 TYPE 0012 2 
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8.3.5 Errcjr Conditions 


There are a number of error conditions which prevent the execution of the file definition commands (os previously 
described). One of the following error messages is typed by Monitor in the event that an error condition is 
detected: 


FILE NOT OPEN An EXTEND, REDUCE, PROTECT, or RENAME command 

has been issued for an internal file number for which no file 
is open. 

FILE IN USE An EXTEND, REDUCE, PROTECT, or RENAME command has 

been issued for a file which is in use elsewhere by another 
user. Because changing a file which is being used (i.e., has 
been opened) could disrupt another user's work, under these 
conditions such a change is prohibited. 

NOTE 

Changing a file which the user himself has opened on another 
internal file results in this error message. 


DIRECTORY FULL 


PROTECTION 

VIOLATION 

FILE NOT FOUND 

FAILED BY n 
SEGMENTS 


A CREATE command has been issued, but the user's directory 
is full. He can delete any of his files to make room for the 
new file. 

An attempt has been made to change a file which is write 
protected against the user. 

The user has attempted to OPEN a nonexistent file. 

The user has attempted to extend a file, but the system has run 
out of disk segments. The number of segments requested, but 
not available, is typed out. 


8.4 SAVING AND RESTORING USER PROGRAMS 

Once a file has been defined, the user can save all or any part of his user core in the file. Files and user core 
are addressed in the same way, by 12-bit words. The user can transfer his file into any part of core. 

The SAVE command requires one to five parameters. The name of the file to be written into must always be 
given. If the file is not in the user's own library, the appropriate account number is entered before the file 
name. (Writing into a file owned by another user is subject to file protection.) In either case, the parameters 
are separated by spaces . 

SAVE Write the indicated section of core out into the indicated file. 

If no parameters follow the file name. Monitor starts at location zero of the user's core and saves it in location 
zero of the disk file. It continues to write core locations into the disk file until: (a) it has written out the 
whole 4K or (b) it has filled the file. Either condition completes the SAVE. 
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The user can further define his SAVE command by indicating specific ports of core to be saved in specific parts 
of the disk file. He does this by typing one to three parameters following the file name. The first parameter 
following the file name indicates a specific disk file address at which to begin writing. The second parameter 
following the file name indicates a specific core address at which to terminate the transfer. If only the first 
two parameters are typ)ed, the transfer terminates when either the end of core or the end of file is reached. 


SAVE SI 
SAVE Cl SI 


SAVE SI C2 C3 C4 


Assuming that a disk file SI exists, and that it is not write 
protected, the contents of core is soved in SI . In the first 
case, SI is assumed to be in the library of the user giving the 
command. In the second case, it Is assumed to be in the 
library of the user whose occount number is Cl . 

Locations C3 to C4 (irx:lusive) are saved in file SI starting at 
disk file location C2. SI is assumed to be in the user's own 
library. If SI is preceded by the parameter Cl, it is assumed 
to be in the library of the user whose account number is Cl . 


Once a core image has been saved in a disk file, it can be restored to core by means of the LOAD command. 

It should be noted that the Monitor command LOAD is very different from the System Library Program LOADER. 
LOADER loads a BIN format file (created by PAL-D) into the user's core. LOAD loads a SAVE format file 
(created by a previous SAVE command) into core. 


The LOAD command requires from one to five parameters. The name of the file to be loaded must always be 
given. If the file is in the user's own library, this file name is typed after the SAVE command itself. If it is in 
another user's library, his account number is entered before the file name. (Reading another user's file is sub- 
ject to file protection.) In either case, the parameters are separated by spaces. 


LOAD 

LOAD SI 
LOAD Cl SI 


Read the indicated section of a disk file into the indicated 
section of core. 

Assuming that a disk file SI exists, and that it is not read protected, 
the contents of the file SI is loaded into core. In the first case SI 
is assumed to be in the library of the user giving the command. In 
the second case. It is assumed to be in the library of the user whose 
account number is DI. 


The user can further define his LOAD command by using the same optional parameters discussed in the section 
on the SAVE command. 


Example: 


LOAD SI C2 C3 C4 Locations C3 to C4 (inclusive) are loaded from file SI starting at 

file location C2. 


.LOAD NEWF 5 10 17 Words 5 to 14 (inclusive) of the file named NEWF are loaded into 

locations 10 to 17 of the user's core. 
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It is not necessary to open a file before using it in a LOAD or SAVE command. Both commands automatically 
open the specified file on internal file number 3 before performing the transfer. After completion of the com- 
mand, the file remains open on file number 3. 


A special macro-command, RUN, exists to allow a program to be loaded and started all in one command. 

RUN SI Load file SI into core from the disk and start execution at location 0. 

RUN Cl SI In the first example, file SI is assumed to be in the user's own library. 

In the second, it is assumed to be in the library of the user whose 
account number is Cl. 

RUN SI is exactly equivalent to LOAD SI; START 0. RUN Cl SI is 
exactly equivalent to LOAD Cl SI; START 0. 


The R command (see Chapter 2, Section 2.4) is a special case of the RUN command. 


R SI 


Load file SI from the System Library (account number 2) and start 
at location 0. R SI is exactly equivalent to RUN 2 SI . 


8.5 UTILITY COMAAANDS 

TSS/8 Monitor provides a number of special purpose commands to aid in program development and use. 


Command 

Explanation 

USER 

Print the number of the job connected with this user and the console 
number of the job. 

USER Cl 

Print the console numbers of job Cl . 

SWITCH Cl 

Set the user's switch register to Cl . Monitor maintains a switch 
register for each user. When his program executes an OSR (OR 
the switch register into the AC) this value is the one which is loaded. 

BREAK 

Type the current value of the user's delimiter mask. 

BREAK Cl 

Set the user's delimiter mask to Cl. (The use of the delimiter mask 
is discussed in the chapter on assembly language programming.) 

DUPLEX 

Place the user's Teletype in duplex mode. All characters typed at 
the keyboard ore automatically printed as they are entered. 

UN DUPLEX 

Take the user's Teletype out of duplex mode. Input characters are 
received by the Monitor and by the user program without their being 
printed at the console. 

RESTART Cl 

Set the user program restart address to Cl . If CTRL/C is typed at 

the keyboard. Monitor forces a jump to location Cl in the user's program. 

VERSION 

Type out the version of TSS/8 Monitor being used. 
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CHAPTER 9 

WRITING ASSEMBLY LANGUAGE PROGRAMS FOR TSS/8 


9. 1 INTRODUCTION 

In addition to the higher-level programming languages available in the TSS/8 library, the user can also code 
and run programs written in the PDP-8 assembly language, PAL-D (Program Assembly Language). These programs 
are prepared with EDIT, assembled with PAL-D, then loaded with LOADER. For those users unfamiliar with as- 
sembly language programming, the DEC Introduction to Programming is a useful guide. 

A user can program TSS/8 }ust as he would any other 4K PDP-8. (Assembly language programs must fit in 4K of 
core.) AM memory reference Instructions (AND, TAD, ISZ, DCA, JMS, and JMP) function as on a stand-alone 
PDP-8. All operate instructions (instruction code 7) also function as on a regular PDP-8 (Exception: micro- 
coding HLT or OSR with any other operate instruction but CLA gives unpredictable results). 

The major difference between TSS/8 programming and regular PDP-8 programming is in the lOT (Input/Output 
Transfer) instructions. Some Instructions which are valid on stand-alone PDP-8s, such as CDF, CIF, ION, lOF 
are considered illegal instructions under time-sharing. There are a great many new lOTs within TSS/8 that are 
not valid on a regular PDP-8. Finally, there are lOTs which operate on TSS/8 in the same manner as on stand- 
alone PDP-8s. 

The way TSS/8 actually executes an lOT instruction is also different. Non-IOT instructions (except HLT and 
OSR) are executed by the TSS/8 hardware, while lOTs (and HLT and OSR) are not. As explained in Appendix C 
lOTs are privileged instructions, executed by the TSS/8 Monitor rather than by hardware. 

In general, TSS/8 provides the programming capabilities of a 4K PDP-8, and allows programs of considerobly 
greater complexity to be run within the constraints of each user's 4K of core. The TSS/8 Library Programs, all 
of which were written in assembly language and make use of the TSS/8 lOT's dealt with below, are examples 
of programs which can be run on TSS/8. 
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9.2 CONSOLE I/O 

User programs handle console (Teletype) I/O in almost the same way as stand-alone PDP-8 programs. The KRB 
instruction is used to input a character, the TLS instruction to output a character. The KSF and TSF (followed by 
JMP .-1) can be used but are not needed. TSS/8 Monitor handles all timing problems whether these skip lOTs 
are present or not. 

TSS/8 differs from the stand-alone PDP-8 in that under TSS/8 the user program interacts with multi-character 
input and output buffers (maintained by TSS/8 Monitor) rather than with single character registers. Depending on 
the state of the system, these buffers may have one, many, or no characters in them. During normal program 
execution, this fact is of no consequence. User programs still send and receive characters one at a time. There 
are times, however, when it is useful to clear out any and all characters in the buffers; a special lOT exists for 
this purpose (SBC). 

On a stand-alone system, choracters are input os soon as they are typed, whether they are of immediate interest 
or not. Usually, these characters are stored away by the program until a terminating (or delimiting) character is 
found. At this time, the whole line of choracters is processed. On a swapping, time-sharing system such as TSS/8, 
this mode of operation is wasteful. It is far more efficient to allow input characters to accumulate in the Monitor 
input buffer until a delimiter is found. There is an lOT to specify which characters are to be considered de- 
limiters (KSB). 

TSS/8 also allows programs to input and output strings of characters. The read string (KSR) and send string (SAS) 
instructions provide a convenient and efficient means of doing lengthy transfers. 

All keyboard input uses full -duplexed hardware, (there is no wired connection between the keyboard and printer, 
i.e. , characters are not printed on the console as typed). Input characters are echoed to the console under pro- 
gram control rather than by hardware. Because input characters are allowed to accumulate in buffers before 
being passed to the user program, it is important to hove Monitor perform the echoing rather than user programs. 
There is an lOT (DUP) to set up this automatic echoing as well as an lOT (UND) to inhibit echoing for such 
operations as reading tapes. 

Read Keyboard Buffer (KRB) Octal Code: 6036 

Operation: Read the next input character into bits 4-11 of the AC. 

Load Teleprinter Sequence (TLS) Octal Code: 6046 

Operation: The ASCII character in AC bits 4-11 is typed out on the user's console. 

Skip on Keyboard Flag (KSF) Octal Code: 6031 

Operation: The next instruction is skipped if there is a delimiter character in the user's input buffer. 
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Read Keyboard String (KSR) 


Octal Code: 6040 


Operation: Execution of this instruction initiates a transfer of one or more characters from the user's keyboard 
to a designated core area. Before executing KSR, load the AC with the address of a two-word block, where: 
Word 1 : negative of the number of characters to be transferred. 

Word 2: address of the core area into which characters are to be placed minus one. 

The transfer is terminated when either: 

a. the indicated number of characters have been input or 

b. a delimiter is seen. At the end of the transfer, the word count and core address are updated 
and the AC is cleared. 

Send A String (SAS) Octal Code: 6040 

Operation: Before executing an SAS, load the AC with the address of a two-word block, where 
Word 1: contains the negative of the number of characters to be sent. 

Word 2: contains the address -1 of the first word of the string. 

The characters are stared one per word right justified starting at the adckess specified by word 2. Upon execution 
of SAS, the system takes only os many characters as will fit in the output buffer. It then makes the appropriate 
adjustment to word 2 to indicate a new starting address and to word 1 to indicate the reduced character count; 
it returns to the instruction following the SAS. If the character count is reduced to zero, the instruction follow- 
ing SAS is skipped. The instruction following the SAS should contain a JMP .-2 to continue the block transfer 
of Teletype characters. The AC is cleared by SAS. 

Set Keyboard Break (KSB) Octal Code: 6400 

Operation: Rather than activate a user's program to receive each charocter os it is typed, TSS/8 accumulates 
input characters until a certain character or characters is seen. To tell TSS/8 Monitor which characters to look 
for (these characters are referred to as delimiters,) load the AC with a 12-bit mask before executing a KSB. For 
each bit in the mask which is set. Monitor considers the corresponding character or characters to be delimiters. 

Bit Specifies 

0 0 = check rest of mask 

1 = any character is break 

1 301-332 (all letters) 

2 260-271 (all numbers) 

3 211 (Horizontal tab) 

4 212-215 (line feed, vertical tab, 

form feed, RETURN) 

5 241-273 (!"#$%&■()*+,-./:;) 

6 240 (spoce) 

7 274-300 (< = > ? @) 

8 333-337 ( [ \] f -) 

9 377 (rubout) 

10 375 (alt mode) 

11 anything not in bits 1-10 
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Duplex (DUP) Octal Code: 6402 

Operation: DUP informs Monitor that the user wishes each character typed at the console to be echoed on that 
console's printer as it is received by Monitor. The DUP instruction does not affect the user's registers. 

Unduplex (UND) Octal Code: 6403 

Operation: UND informs Monitor that the user wishes to suppress character echoing. This can be done for 
reasons of privacy or because a program does its own character echoing. The user's registers are unaffected 
by UND. 

Set Buffer Control (SBC) Octal Code: 6401 

Operation: SBC permits the user program to clear its Teletype input and/or output buffer. Before executing SBC 
set bits 0 and 1 of the AC as indicated below: 

Bit 0 Clear output buffer 

Bit 1 Clear input buffer 

9.3 FILES AND DISK I/O 

All user programs can gain access to the TSS/8 disk storage. The time-shoring Monitor maintains a pool of 
available disk space which is allocated in units referred to as segments. (The size of a disk segment varies 
among TSS/8 installations. Segments may be 128 , 256 , 512, or 1024 words each). These segments are used 
to make up user files on the disk. Monitor also maintains, for each user, a directory of all files which he has 
defined. 

The lOTs which allow the user to access the disk are of two types: those which define files on the disk and 
those which transfer data between a defined file and the user's core. 

NOTE 

CREATE and OPEN require that a user set up a file name 
in core. FINF and WHO return file names to core. Each 
must be specified in TSS/^ internal code (excess 40 code) 
as shown in Appendix A. Characters are packed two to 
a word. 

The first step in defining a file is to create it. Creating a file reserves a single segment of disk storage and 
associates it with a name. This file can then be extended to any length desired. Extending a file appends more 
segments to it. Similarly, a file can be reduced by any number of segments. Reducing a file removes the last 
segment or segments from the file. Reducing a file to zero segments deletes it entirely. Once created, a file 
can be protected, thereby restricting access to it. When created, a file can be read by any user, but only the 
creator can write in it. This protection can be reset if desired. Finally, it Is possible to rename an existing 
file. 
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None of these actions affect the contents of the file — they only reserve space on the disk. Until it has been 
written in, the actual content of a file is unspecified. Extending a file does not alter the content of the file 
as it previously existed. Once defined, files can be used to read and write data. Any number of words (1 to 
4096) can be moved from any part of the user's core to any part of a file (subject to file protection). The user 
program specifies a location in core and a word count. This indicates how many words are to be transferred 
and from (or to) where in core they are to be moved. Also specified is a disk file address indicating what port 
of the file is involved. This address is the address of a word in the file. Files are addressed in the same manner 
as core: in 12-bit words. Unlike core, however, files can be longer than 4K. To addkess these files provision 
is made fora 24-bit disk file address, containing the high-order and low-order file addresses. 

File addresses are independent of any consideration of segments. The file adckess is meaningful only in defining 
files. Files can be read and written across segment boundaries without restriction. (The user cannot read or 
write beyond the last segment boundary.) 

When it executes a file read or write lOT, the system updates the core address and word count and places an 
error code in the error word (see RFILE) if any error is detected. (The error word must be cleared before execut- 
ing the lOT.) At the end of a successful transfer, the word count is set to zero and the core address set to the 
last word transferred. If the transfer cannot be completed for some reason, the word count and core address 
indicate how much of the transfer was successful; the error word indicates the cause of the failure. All file 
operations except CREATE (and OPEN) require that the file be open. Up to four files can be open at a time. 
The process of opening a file associates it with one of four internal file numbers (0, 1, 2, or 3). All file lOTs 
except GREAT and OPEN, ore specified in terms of one of these internal file numbers, rother than a file name. 
lOTs operate on the file which is indicated by that internal fite number at the time. It is therefore possible to 
write file handling programs which are independent of the actual file(s) they operate on. 

File lOTs, that are successfully completed, return with the AC cleared. If an error was found which prohibited 
execution of the lOT, one of the following error codes is returned: 

4000 There was no file opened on the specified internal file number. 

4400 Attempting to redefine a file which is open to another user. 

5000 Attempting to create a file for a user whose directory is full . 

6000 File protection violation. 

6400 Invalid file name. 

7000 Attempting to open a nonexistent file. 

7400 Disk is full . 


Create a File (CRF) Octal Code: 6610 

Operation: the user can request the system to create a new file of one segment. The user program provides the 
new name for the file. Load the AC with the beginning address of a 3-word block, where 
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Words 1 through 3: contain the 6-character name. 

If there is some reason why the request cannot be granted, the system will return a non-zero error code in the AC. 
The protection code of a newly created file is 12. 

Extend A File (EXT) Octal Code: 6611 

Operation: To extend the length of an existing file, that file must be currently open. Load the AC with the 
beginning address of a 2-word block, where: 

Word 1: contains the internal file number of the file to be extended. 

Word 2: contains the number of segments the system should append to the file. 

If for some reason the request to extend a file cannot be granted, the AC will contain 4000 , 4400 , 6000, or 

the number of segments it failed to append. 

Reduce A File (RED) Octal Code: 6612 

Operation: To reduce the length of an existing file, that file must be currently open. Load the AC with the 
beginning address of a 2-word block, where: 

Word 1; contains the internal file number of the file to be reduced. 

Word 2: contains the number of segments to be removed. 

This request is granted unless the file to be reduced is cwrently opened to another user or if the file is write 
protected against the user. 

Rerxime A File (REN) Octal Code: 6600 

Operation: REN is used to change the name of a file. Load the AC with the addtess of a 4-word block where; 

Word 1: contains the internal file nunfcer associated with the file whose name 

is to be changed. 

Words 2-4: contains the new name. This name is in 6-bit characters packed two in 

o word. 

Protect A File (PROT) Octal Code: 6604 

Operation: The owner of a file can protect his file from unauthorized attempts to access it by using this in- 
struction. Before executing PROT, load the AC with: 

Bits 5 and 6 Internal file number of the reserved file to be protected. 

Bit 7 Write protect against owner. 

Bit 8 Write protect against users whose project number is same as owner's. 

Bit 9 Read protect against users whose project number is same as owner's. 

Bit 10 Write protect against users whose project number differs from owner's. 

Bit 1 1 Read protect against users whose project number differs from owner's. 
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A file must be opened before it con be protected. PROT is legal only when performed by the file owner, i.e. , 
the user who created the file. All attempts to access the file which violate any of the protection flags are con- 
sidered illegal. (For further information on project numben, see Appendix F.) 

Open A File (OPEN) Octal Code: 6601 

Operation: OPEN is used to associate a file with an internal file number, which is necessary because all file 
operations are in terms of the internal file numbers. Before executing the OPEN lOT, load the AC with the 
beginning add'ess of a 5-word block, where: 

Word 1: contains the internal file number. 

Word 2: contains the account number of the owner of the file. If 0, the 

account number of the current user is specified. 

Word 3-5: contain the name of the file to be opened. This name is in 6-bit 

characters packed two to a word. 

If there was another file associated with the internal file number before the execution of the OPEN lOT, it is 
closed automatically before the new file Is associated with the internal file number. 

Close A File (CIOS) Octal Code: 6602 

Operation: CLOS terminates the association between files and their internal file numbers. Before executing 
CLOS, load the AC with a selection pattern for the internal file numbers whose associated files are to be closed. 
The file is closed if bit I is 1 , where I = bit 0, 1 , 2, or 3. 

Read File (RFILE) and Writ® File (WFILE) Octal Codes: 6603 & 

6605 

Operation: Once the associotion of a file with an internal file number has been mode, these lOTs allow the 
actual file reference to be made. They ore illegal on a file that hos not been opened (associated with an in- 
ternal file number). 


To read or write a file. 

load the AC with the address of a 6-word block, then execute the lOT. The format 

for the 6-word block is: 

Word I: 

contains the high-order file word address. 

Word 2: 

contains the internal file number. 

Word 3: 

contains the negative of the number of words for the operation. This 
number is either the nunier of words to be read or the number of words 
to be written. 

Word 4: 

contains a pointer to the beginning address -I of a buffer located in the 
user program. On a read operation this buffer receives the information 
from the file: on a write operation this buffer holds the information that 
is to be sent to the file. 

Word 5: 

contains the least significant 12 bits of the initial file word address to 
begin the operation. 
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Word 6: 


confams on error code: 


0 if no error 

1 if parity error 

2 if file shorter than word count 

3 if file not open 

4 if protection violated 

The read or write begins at the word specified by words 1 and 5. For example: 


TAD X 
WFILE 


0 

1 

-200 

6A77 

200 


means: write 200 (octal) words starting at word 200 of the file that is associated with internal file number one 
from a core area starting at location 6500. 

After completion of the transfer, the word count (word 3) and core address (word 4) ore updated. If on error 
was detected the appropriate error code is placed in word 6. 


File Information (FINF) 


Octal Code: 6613 


Operation: FINF enables a user program to determine what file, if any, is associated with an internal file 
number. Load the AC with the beginning address of a 7-word block, where: 


Word 1: 

Words 2 
through 7 

Word 2: 

Words 3-5: 
Word 6: 


contains the internal file number for which the user program wishes information, 
contain the information that the system returrs after executing FINF. 

contains the account number of the owner or zero if no file is associated 
with the internal file number, that is, the file is not open. 

contains the name of the file in 6-bit code. 

contains: 

Means 


Bit-1 

7 

8 


10 


write protected against owner 

write protected against users whose project 
number is same as owner's 

read protected against users whose project 
number is same as owner's 

write protected against users whose project 
number differs from owner's 
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Word 6 (Cont) 


Bi^-1 

11 


Means 


read protected against users whose project number 
differs from owner's 


Word 7: 


contains the number of segments which compose the file. 


9.4 ASSIGNABLE DEVICES 

Users can access both their own Teletypes and the disk; with the remaining system devices (referred to as the 
assignable devices) this Is not true. One function of the TSS/8 Monitor is to ensure that device usage never 
conflicts. Only one user at a time can access the high-speed, paper-tape reader or punch, or any one of the 
DECtapes. 

To ensure that only one user can access a device, TSS/8 requires that the device be assigned before it is used. 
After a device is assigned, it is not available until it is released by its owner. 

Once assigned, the device is programmed exactly as on a stand-alone PDP-8. The RRB instruction is used to 
read a character from the high-speed reader; the PLS Instruction is used to punch one on the high-speed punch. 
The skip lOTs (RFS and PSF) can be used (followed by JMP . -1) but are not necessary. For block transfers, 
there are two string transfer commands: RRS and PST. 

The DECtape instructions have been simplified. A single instruction, DTXA, initiates the transfer of a block of 
data. The DTRB instruction is then used to determine if the transfer was successful. The skip instruction, DTSF, 
can be used (followed by JMP .-1) but is not necessary. 

Executing any of the assignable device lOTs without first assigning the device gives the following results: (a) If 
the device is assigned to another user, the instruction is considered illegal; program execution is now terminated 
and an error message typed out; (b) If the device is available it is automatically assigned before execution of 
the lOT. The device then belongs to this user until he releases it. 

Because these devices are shared by all users. Monitor must ensure that they are operable at all times. In par- 
ticular, Monitor must ensure that a user is not waiting (futilely) for a device which is not available. This 
situation can arise when trying to use the punch when it is turned off, or when the reader has read off the end 
of a tape. All these conditions, referred to as "hung devices" are considered to be system errors. If the program 
doing the transfer has been enabled for system errors, (by executing an SEA) control transfers to the error routine 
indicated which must clear the error flag in the status word before continuing (see Section 9.4). If the user 
program has not been enabled for system errors, a hung device causes the program to be terminated and an error 
message is typed out. 
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Assign Device (ASD) 


Octal Code: 6440 


Operation: If the device specified by the contents of the AC is available, it is assigned to the user program 
and the AC is cleared. Otherwise, the number of the job owning the device is placed in the AC. If the de- 
vice does not exist, 7777 is returned in the AC. 

4000 Paper-tape reader 

4001 Paper-tape punch 

4005 + N DECtape unit N 

The assignment is in effect until a corresponding REL instruction or LOGOUT. 

Release Device (REL) Octal Codes: 6442 

Operation: The device specified by the contents of the AC is released (providing it was owned by the user 
executing the REL). The AC is cleared. Releasing a device makes it available to other users. 

Skip on Reader Flog (RSF) Octal Code: 6011 

Event Time: 1 

Operation: The reader flag is sensed, and if it contains a binary 1 , the contents of the PC are incremented by 
one so that the next sequential instruction is skipped. The reader flog is bit 8 of status register 1, and has a 
value of 1 if the reader buffer is not empty. 

Read Reader Buffer (RRB) Octal Codes: 6012 & 

6016 

Event Time; 2 

Operation: The contents of the reader buffer are transferred into bits 4 through 1 1 of the AC and the reader flag 
is cleared if the reader buffer is empty. This instruction does not clear the AC. If the reader buffer is empty, 
the user program is dismissed until the reader flog is 1 or an end-of-tope condition is detected. 

Reader Fetch Character (RFC) Octal Code: 6014 

Event Time: 3 

Operation: The reader flag and the Monitor reader buffer are both cleared, the reader is started to fill the 
Monitor reader buffer and the reader flag is set after the buffer is full or the end of tape is detected. 

Read Reader String (RRS) Octal Code: 6010 

Operation: This instruction initiates a transfer from the high-speed reader to a selected orea In the user's core. 
Before executing RRS, load the AC with the address of a 2-word block, where: 

Word 1: minus the number of characters to be transferred. 

Word 2: the address of the user core area minus one. 

The transfer is terminated by either of two conditions; (a) the word count is zero indicating that the required 
number of characters have been read or 0^) fhe reader has read off the end of the tc^ (a system error condition). 
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In either case, the word count and core address are updated. RRS clears the AC. 

Load (\inch Buffer Sequence (PLS) Octal Code: 6026 

Operation: The ASCII character is in AC bits 4 through 1 1 and is transmitted to the high-speed punch. PLS 
does not clear the accumulator. 


Skip on Rjnch Flag (PSF) Octal Code: 6021 

Event Time: 1 

Operation; The punch flag is sensed, and if it contains a binary 1, the contents of the PC is incremented by one so 
that the next sequential instruction is skipped. The punch flag is bit 9 of status register 1 , and has a value of 1 
if the punch buffer is not full. If the punch flag is 0, the program is dismissed until the punch flag is 1. 

Punch String (PST) Octal Code: 6020 

Operation: PST allows a user program to punch a string of characters. Before executing PST, load the AC with 

the beginning address of a 2-word block, where: 

Word 1: contains the negative of the number of characters to be punched. 

Word 2: contains the beginning address -1 of the string to be punched; the 

characters should be right justified one per word. 

After execution of PST, the system takes only as many characters as fit in the punch buffer; it then makes the 
appropriate adjustment to word 2 to indicate a new starting address and to word 1 to indicate the reduced char- 
acter count. It returns to the instruction following the PST which should be a JMP .-2 to continue the transfer. 

If the character count is reduced to zero, the instruction following PST is skipped. The AC is cleared by PST. 


Load Status Register A (DTXA) Octal Code: 6764 

Operation: DTXA allows a user program to read and write records (129-word blocks) on DECtape, Load the AC 
with the beginning address of a 3-word block, where: 

Word 1: contains: 


Bit 1 
0-2 
3-5 

6-8 = 2 
4 

9-n 


Means 

contains the transport unit select number, 

0 , 

for read data function, 
for write data function, 

0 . 


Word 2: contains the DECtape block number. 

Word 3: contains the beginning core address -1 of record buffer. 

After DTXA is given, the DECtape request is placed in the DECtape request queue. After the completion of 
any DECtape request, the DECtape flag in status register 2 is turned on. DTXA does not update word 3. The AC 
is cleared by DTXA. 
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Octal Code: 6771 


Skip on Flags (DTSF) 

Operation: The content of both the error flag and the DECtape flag is sampled, and if either flag contains a 
binary 1 , the content of the PC is incremented by one to skip the next sequential instruction. If both flags are 
zero, the user program is dismissed until the skip is satisfied. 

Read Status Register B (DTRB) Octal Code; 6772 

Operation; The content of DECtape status register B is loaded into the AC by an OR transfer. The AC bit as- 
signments are: 

0 
1 
2 

3 

4 

5 

6-10 

11 

9.5 PROGRAM CONTROL 

There are a number of ways that the status of a running program can be changed. The program can be terminated 
in one of three ways: by execution of a HLT, by the user typing fBS to force a program halt, or by a program 
error which forces Monitor to terminate the program after typing out an error message. 

It is also possible for the status of a running program to change without it being terminated. First, the user 
program can request that it handle its own program error conditions. In this case. Monitor does not terminate 
a [ob on an error; instead, it transfers control to a user error handler. This error handler then determines what 
the error was, by a CKS instruction and takes appropriate action. Monitor also provides the program with an 
interrupt key, fC.^ If the user types a fC, Monitor unconditionally transfers control to a restart address. Thus, 
the user program can handle its own restarts. 

Halt (HLT) Octal Code: 7402 

Operation: This instruction is used to stop the user program and return control to Monitor. Executing HLT is 
equivalent to typing tBS followed by RETURN. 


error flag 
mark track error 
end of tape 
select error 
parity error 
timing error 
unused 
DECtape flag 


^ fC is a control character obtained by depressing the CTRL key at the same time as depressing the C key. tBS 
is obtained by depressing control key and B together followed by S. 
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Set Restart Address (SRA) 


Octal Code: 6417 


Operation: This instruction allows the user to specify an address to which control is transferred when an tC is 
typed on the user's console. Load the AC with the restart address and execute SRA. If tC is detected , the 
program's input and output buffers are cleared, the AC and Link are cleared and control goes to the restart 
address . 

Set Error Address (SEA) Octal Code: 6431 

Operation: This instruction allows the user to specify an address to which control is transferred in the event of 
a system error. Load the AC with an address before executing SEA. If a system error is detected. Monitor 
simulates a JMS to the error address. The program counter is stored in the error address and control transferred 
to the error address +1. AC, Link, and input/output buffers are not affected. The error code of the system error 
is in STRO bits 9-11. Bit 10 of STRl is set. The error routine must read these bits (by a CKS) to determine the 
cause of the error, then clear them by means of a CLS. 

The only error code that occurs in the course of normal system usage is due to a hung device. This error occurs 
when the user attempts to use a punch not already turned on, access a DECtape not yet selected, or allows the 
paper-tape reader to run off the end of a tape. The error routine must release the device to clear the error condi- 
tion. The illegal lOT error probably means that an assignable device lOT was executed without the device first 
being being assigned. Swap and file errors occur if a hardware error is detected while Monitor is swapping user pro- 
grams or while reading or writing file directories. These are system malfunctions from which there is no recovery. 

9.6 PROGRAM AND SYSTEM STATUS 

Because TSS/8 programs run under control of a time-sharing Monitor, it is important for them to determine their 
status within the system and the status of the system as a whole. Several lOTs, listed below, have been de- 
fined for this purpose. 


Check Status (CKS) Octal Code: 6200 

TSS/8 Monitor maintains for each user a complete set of status information, his program's running status and the 
state of his input/output devices. This status information, stored in three words, can be accessed by a running 
program with the CKS instruction. Before executing a CKS, load the accumulator (AC) with the address of a 
three-word block. Executing CKS stores the three status words (STRO, STRl , and STR2) in the three-word block 
and clears the AC. Information about the status of individual devices can also be checked by the skip lOTs. 
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The formats of these registers are: 
STRO Bits 


0 Run Bit 

1 Error Enable 
2-4 

5 JSIOT 

6 JSIOTC 

7 JSEXON 

8 

9- 1 1 Error Code 


STRI Bits 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

STR2 Bits 

0-8 

9 

10 
11 


Timer 
File 0 
File 1 
File 2 
File 3 
Delimiter 

Teleprinter 

Reader 

Punch 

Error 

Wait 


DECtape 

Error 

DECtape 


User program is in the run state 
Program handles its own errors 
Unused 

System use cxily 
System use only 
System use only 
Unused 

System detected error condition 

1 Illegal lOT 

2 Swap read error 

3 Swap write error 

5 Disk file error 

6 Hung device 


Time is up 

Internal file 0 is not busy 

Internal file 1 is not busy 

Internal file 2 is not busy 

Internal file 3 is not busy 

There is a delimiter in the input buffer 

Unused 

Output buffer is not ful I 

Character in reader buffer 

Punch buffer is not full 

System error detected, code in bits 7 

through 1 1 of STRO 

Job is not waiting 


Unused 

DECtape transfer requested 
DECtape error 
DECtape flag 


Each user has available to him a 12-bit switch register just as he does on a stand-alone PDP-8. This switch 
register can be manipulated by means of the Monitor command SWITCH or under program control . 


OR With Switch Register (OSR) Octal Code: 7404 

Operation: The content of the user's switch register is inclusively ORed into the AC. 

Set Switch Register (SSW) Octal Code: 6430 

Operation: The content of the AC is stored in the user's switch register. The AC is cleared. 


Assembly language programs run under control of TSS/8 Monitor. The following lOTs are defined to allow a 
program to determine the status of the system as a whole. 
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Segment Size (SIZE) 


Octal Code: 6614 


Operation: The segment is the basic unit of on-line file storage. Different TSS/S systems have differing segment 
sizes. SIZE allows a program to determine the segment size. The segment size is returned in the AC. 


Segment Count (SEGS) 

Operation: The number of available disk segments is returrted in the AC. 


Account (ACT) 


Octal Code: 6406 


Octal Code: 6617 


Operation: The account number (of the job number given) is returned in the AC. If AC is 0, the account 
number for the current job is returned. If the requested job does not exist, zero is returned. 


Who (WHO) 


Octal Code: 6616 


Operation: The account number and password of the current job are returned to the 3-word block whose address 
is in the AC and the AC is cleared. 


User (USE) 

Operation: Return in the AC the number of the current job. 


Console (CON) 


Octol Code: 6421 


Octal Code: 6422 


Operation; Return in the AC the console unit number assigned to the job whose number is in the AC, if that 
console number does not exist, -1 is returned. 


User Run Time (URT) 


Octal Code: 6411 


Operation; Load the AC with the address of a 3-word block, where word 1 contains the number of the job 
for which the run time is sought. The run time is returned in the last two locations of the block. If job 0 is 
specified, the lun time of the current job is returned. The AC is cleared. 

Time-of-Day (TOD) Octal Code: 6412 

Operotion; Returns the value of the System Clock in military time (using a 24-hour cycle) in the two locations 
starting at the location of the address in the AC. The AC is cleared. 


Return Clock Rate (RCR) 

Operation: The number of clock ticks per second is returned in the AC. 

Date (DATE) 

Operation: Returns the date in the AC. The format of this 12-bit number is: 

DATE=( (YEAR- 1 964 ) *1 2+ ( MOMTH- 1 ) )*31 +DAY-1 


Octal Code: 6413 


Octal Code: 6414 
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Skip on TSS/5 (TSS) 


Octal Code: 6420 


Operation: This instruction is used by programs which run under both TSS/^ and a standard PDP-8/1. Under 
TSS/8, the instruction following TSS is skipped and the Monitor version number is returned in the AC. On a 
standard PDP-8/I, the lOT has the effect of a NOP instruction. 

Quantum SytTchronization (SYN) Octal Code: 6415 

Operation: Upon execution of this instruction, the system dismisses the user program and sets it in the run state 
so that it will be run again in turn. Ordinarily, this instruction is used to ensure a full time quantum to perform 
some critical operation. 

Set Time (STM) 

Operation: The system provides a clock time for each user program, 
to "fire" after a specified number of clock ticks have elapsed. 

Load the AC with the time (in seconds) to prime the timer. Upon execution of the STM instruction, the system 
sets the time to "fire" in the specified number of seconds and turns the time bit (bit 0) in status register 1 to 0, 
clears the AC, and dismisses the job. After the specified time has elapsed, the system turns bit 0 back to 1, 
and the job is restarted. 

9.7 PDP-8 COMPATIBILITY 

Programming TSS/8 in assembly language is very similar to programming a stand-alone PDP-8. All instructions 
except the lOTs operate identically in either case. As discussed in the earlier sections of this chapter, program- 
ming such devices as the Teletype and high-speed reader/punch for TSS/8 is somewhat simpler. TSS/8 runs 
programs which include timing loops. It also properly executes the lOTs not mentioned in this manual, e.g. , 
TCP, PCF, RRB, RFC, etc. Thus, programs written for stand-alone PDP-8s with Teletype and high-speed reader 
or punch will run on TSS/^, although generally not as efficiently as programs which are written specifically 
for TSS/8. 

The same is not true for disk and DECtape operations because TSS/8 uses a simplified programming structure for 
these devices. The actual differences in coding are very small. It is a simple task to adapt previously written 
code for TSS/8 disk and DECtape. 

There are a few standard changes which users generally make in adapting PDP-8 code to TSS/8. The TSS/8 
Monitor does the echoing rather than the user program. The TLS which does the echo can be deleted and a DUP 
instruction added somewhere near the stcnT of the program. Also, for efficiency, the TSS/^ delimiter capability 
can be used. A KSB in the program determines what the delimiters ore. 


Octal Code: 6416 

By means of this lOT, the time can be set 
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Many PDP-8 programs execute a reader and punch lOT early in the program, to initialize the device, whether 
they are actually to be used or not. If the devices are free, they can be assigned and thus made unavailable 
to other users. If they are unavailable, the program terminates on an illegal lOT. Thus, it is important not to 
execute these lOTs randomly. If disk or DECtape is involved the actual transfer code must be altered to con- 
form to TSS/8. (The fact that core page 37, locations 7600 through 7777, is available to TSS/8 programs is 
useful in making these changes. Mew code can be placed in the area normally reserved for the Binary Loader.) 

The most difficult code to convert is that code which operotes under interrupt. To be run under TSS/8, these 
programs must be recoded so as not to use the interrupt . 

lOTs for nonexistent devices are ignored as are CDFs and CIFs to field zero. (Other CDFs and CIFs are illegal .) 
It must be remembered, that many lOTs have been redefined for use as special TSS/8 instructions. In all other 
situations, TSS/^ remains compatible with stand-alone systems whenever possible. 
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APPENDIX A 
TSS/8 CHARACTER SET 


TSS/8 accepts 8-bit ASCII characters only. ASCII is an abbreviation for USA Standard Code for Information 
Interchange. The acceptable characters and their 6- and 8-bit octal equivalents are listed below. 


Character 

6- Bi 1 1 
Octal 

8-Bit 

Octal 

Character 

6-Bitt 

Octal 

8-Blt 

Octal 

Space 

00 

240 

@ 

40 

300 

! 

01 

241 

A 

41 

301 

11 

02 

242 

B 

42 

302 

# 

03 

243 

C 

43 

303 

$ 

04 

244 

D 

44 

304 

% 

05 

245 

E 

45 

305 

& 

06 

246 

F 

46 

306 

1 

07 

247 

G 

47 

307 

( 

10 

250 

H 

50 

310 

) 

11 

251 

I 

51 

311 

* 

12 

252 

J 

52 

312 

+ 

13 

253 

K 

53 

313 

t 

14 

254 

L 

54 

314 

- 

15 

255 

M 

55 

315 


16 

256 

N 

56 

316 

/ 

17 

257 

O 

57 

317 

0 

20 

260 

P 

60 

320 

1 

21 

261 

Q 

61 

321 

2 

22 

262 

R 

62 

322 

3 

23 

263 

S 

63 

323 

4 

24 

264 

T 

64 

324 

5 

25 

265 

U 

65 

325 

6 

26 

266 

V 

66 

326 

7 

27 

267 

W 

67 

327 

8 

30 

270 

X 

70 

330 

9 

31 

271 

Y 

71 

331 


32 

272 

Z 

72 

332 

} 

33 

273 

[ 

73 

333 

< 

34 

274 

\ 

74 

334 

= 

35 

275 

] 

75 

335 

> 

36 

276 

t 

76 

336 


37 

277 

-4- 

77 

337 


tUsed to store passwords and filenames only. 
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APPENDIX B 

SUMMARY OF MONITOR COMMANDS 


B . 1 MONITOR COMMANDS 

A Monitor command is a string of characters terminated by a semicolon (;), a colon (;), or a carriage return 
(RETURN key). Parameters of commands can be octal numbers, decimal numbers, character strings, or single 
letters. In the following summary, parameters are coded as follows: 

C 1 , C2 , . . . represent octal numbers 

D1, D2, . . . represent decimal numbers 

S1,S2, . . . represent character strings 

LI, L2, . . . represent single letters 

B.1.1 Logging In and Out 

LOGIN Cl SI; Request to login; 

Cl = user's account number 
SI = user's password 

LOGOUT; Request to logout; processing 

and console time is typed out 

TIME Cl; Request typeout of processing time; 

Cl = job number 

Without Cl , current job is assumed; 
before logging in and without Cl , 
time-of-day is typed out; 

If Cl = job 0, time-of-day is typed 
out. 


B.l .2 Device Allocation 

ASSIGN LI; Access device; 

LI = R for paper tape reader 
P for paper tape punch 
D for any DECtape unit 

ASSIGN D Cl; Access DECtope unit; 

D = DECtape 
Cl = device number 
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RELEASE Ll; 


RELEASE D Cl; 

B.1.3 Rle Handling 

OPEN Cl SI C2; 

CLOSE SI; 
CREATE SI; 
RENAME Cl SI; 

REDUCE Cl Dl; 

EXTEND Cl Dl; 

PROTECT Cl C2; 


FCl; 


Release device; 

LI = R, P (see ASSIGN LI;) 

D = DECtape unit 

Cl = console or DECtape number 


Establish association between 
internal file number and file; 

Cl = internal file number 
SI = file name 
C2 = account number 

Close fil es; 

SI = list of internal file numbers 

Create new file; 

SI = name of new file 

Rename a file; 

Cl = internal file number 
SI = new name of file 

Reduce length of file; 

Cl = internal file number 
Dl = number of segments to be re- 
moved from end of file 

Extend length of file; 

Cl = internal file number 
Dl = number of segments to be odded 
to end of file 

Protect a file; 

Cl = internal file number 
C2 = new file protection mask 

1 read protect against users 
with different project number 

2 write protect against users 
with different project number 

4 read protect against users 
with same project number 
10 write protect against users 
with same project number 
20 write protect against owner 
or the sum of any combination 

Print out association between internal file 
numbers and files 

Cl = internal file number 
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B. 1 .4 Control of User Programs 


START Cl; 

Execute user program; 

Cl = starting location 

START; 

Restart user program; 

RESTART Cl; 

Set program restart address 

DEPOSIT Cl C2 

Store in core memory; 

Cl = location 

C2 = contents to be stored 


Cn = location Cl+n-1 
n < 10 decimal 

EXAMINE Cl Dl; 

List specified contents; 

Cl = first location 

Dl = number of location to be 
listed Dl < 10 decimal 

B . 1 . 5 Uti 1 i ty Commands 


SAVE SI; 

SAVE Cl SI C2; 

SAVE Cl SI C2 C3; 

SAVE Cl SI C2 C3 C4; 

Save core image; 

Cl = ov/ner's account number 

SI = name of file 

C2 = file address of first word to 
be soved; if not specified, 
entire 4K is saved 

C3 = core address of first word to 
be saved; if not specified, 
entire core is saved 

C4 = core address of last word to 
be saved; if not specified, 
entire core is saved 

LOAD Cl SI; 

LOAD Cl SI C2; 

LOAD Cl SI C2 C3; 

LOAD Cl SI C2C3 C4; 

Load core image; 

Cl = owner's account number 

SI = name of file 

C2 = file address of first word to 
be loaded; if not specified, 
entire 4K is loaded 

C3 = core address of first word to 
be loaded, if not specified, 
entire core is loaded 

C4 = core address of last word to 
be loaded; if not specified, 
entire core is loaded 

R SI; 

Run System file; 

SI = name of file 
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B.1.6 Utility Commands (Cont) 
RUN SI; 

RUN Cl SI; 

S; 

WHERE; 

USER; 

USER Cl; 

SWITCH Cl; 

BREAK Cl; 

DUPLEX; 
UNDUPLEX; 
TALK Cl SI; 


Run user file; 

SI = name of file 

Run user file; 

Cl = owner's account number 
SI = name of file 

Stop execution 

Type out contents of location counter, 
accumulator, link, and switch register 

Type out number of the job and devices 
owned 

Type out device numbers; 

Cl = user's account number 

Set switch register; 

Cl = word to be set 

Set keyboard break mask; 

Cl = new mask 

Echo typed characters on printer 

Ignore previous DUPLEX command 

Send a message to console Cl; 

Cl = destination console 
SI = message 
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APPENDIX C 
SUMMARY OF lOT INSTRUCTIONS 


C . 1 PROGRAM CO NTROL 


Number 

Insfruction 

Function 

6200 

CKS 

Check Status 

6402 

DUP 

Duplex Console 

6403 

UND 

Unduplex Console 

6405 

CLS 

Clear Status 

6411 

URT 

User Run Time 

6412 

TOD 

Time of Day 

6413 

RCR 

Return Clock Rate 

6414 

DATE 

Date 

6415 

SYN 

Quartum Synchronizotion 

6416 

STM 

Set Timer 

6417 

SRA 

Set Restart Address 

6420 

TSS 

Skip on TSS/8 

6421 

USE 

User 

6422 

CON 

Console 

6430 

SSW 

Set Switch Register 

6431 

SEA 

Set Error Address 

6440 

ASD 

Assign Device 

6442 

REL 

Release Device 

7402 

HLT 

Halt 

7404 

OSR 

OR With Switch Register 


C.2 FILE CONTROL 


Number 

Instruction 

Function 

6600 

REN 

Rename File 

6601 

OPEN 

Open File 

6602 

CLOS 

Close File 

6603 

RRLE 

Read Rie 

6604 

PROT 

Protect File 

6605 

WFILE 

Write File 

6610 

CRF 

Create File 

6611 

EXT 

Extend File 

6612 

RED 

Reduce RIe 

6613 

FINF 

File Informotion 

6614 

SIZE 

Segment Size 

6406 

SEGS 

Segment Count 

6617 

ACT 

Account Number 

6616 

WHO 

Who 
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C.3 INPUT BUFFER CONTROL 


Number 

Instruction 

Function 

6030 

KSR 

Read Keyboard String 

6031 

KSF 

Skip On Keyboard Flag 

6032 

KCC 

Clear Keyboard Flag 

6034 

KRS 

Read Keyboard Buffer Static 

6036 

KRB 

Read Keyboard Buffer Dynamic 

6400 

KSB 

Set Keyboard Break 

6401 

SBC 

Set Buffer Control Flags 


C .4 OUTPUT BUFFER CONTROL 

Number 

Instruction 

Function 

6040 

SAS 

Send A String 

6041 

TSF 

Skip On Teleprinter Flag 

6042 

TCF 

Clear Teleprinter Flag 

6044 

TPC 

Load Teleprinter and Print 

6046 

TLS 

Load Teleprinter Sequence 


C .5 HIGH-SPEED PAPER-TAPE READER AND CONTROL (TYPE PC02) 


Number 

Instruction 

Function 

6010 

RRS 

Read Reader String 

6011 

RSF 

Skip On Reader Flag 

6012 

RRB 

Read Reader Buffer 

6014 

RFC 

Reader Fetch Character 


C.6 HIGH-SPEED PAPER-TAPE PUNCH AND CONTROL (TYPE PC03) 


Number 

Instruction 

Function 

6020 

PST 

Punch String 

6021 

PSF 

Skip On Punch Flag 

6022 

PCF 

Clear Punch Flag 


6024 

PPC 

Load Punch Buffer and Punch Character 

6026 

PLS 

Load Punch Buffer Sequence 


C.7 DECTAPE CONTROL (TYPE TCOl) 


Number 

Instruction 

Function 

6764 

DTXA 

Load Status Register A 

6771 

DTSF 

Skip On Flags 

6772 

DTRB 

Read Status Register B 
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APPENDIX D 

OFF-LINE TAPE PREPARATION AND EDITING 


D.1 INTRODUCTION 

To run a program on the computer, instructions and data must be fed into the computer from the input device. 

The program and data are usually typed into the computer on-line or prepared with the aid of the Symbolic 
Editor. It is sometimes convenient to prepare the program and data off-line, that is, to punch the program and 
data onto paper tape using a separate machine, one not actually connected to the computer. 

The Model 33 ASR Teletype can be used off-line to prepare source program tapes, to duplicate tapes, and to 
edit tapes previously punched in the ASCII format. (Tapes punched from the Teletype keyboard are in ASCII 
format . ) 

When the Teletype power control switch Is turned to LOCAL, the unit becomes an off-line tape preparation 
facility. FVocedures for using the Teletype off-line ore listed below. The Teletype controls are described in 
Section 1.4. 


D.2 DUPLICATING TAPES 

The following is a description of the procedure used in duplicating tapes. 

Step Procedure 

1 Turn HY to LOCAL. 

2 Set LSR to FREE. 

3 Put original tape into LSR. 

4 Depress LSP ON. 

5 Depress HERE IS key to generate leader tape. 

6 Set LSR to START. (New tape is punched and data is typed on printer.) 

7 After the original tape is read in, depress HERE IS key to generate trailer 
tape. 

8 Remove tapes from LSR and LSP. 
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D.2.1 Preparing New Program Tapes 

When preparing a program tape off-line, the user should observe the same conventions of his programming 
language as when preparing a program on-line using Editor. The following are the manual operating procedures 
for off-line tape preparation. 


Step Procedure 

1 Turn TTY to LOCAL. 

2 Depress LSP ON. 

3 Depress HERE IS key to generate leader tape. 

4 Type the source program, observing the conventions of the programming language being 
used . 

NOTE 

The RETURN and LINE FEED keys must be depressed at 
the end of each line. 

Depressing the CRTl/TAB keys perforates the tab char- 
acter onto the tape, and the typewheel moves only one 
position to the right. When the computer reads the 
punched tab character on output, the typewheel tabs 
(a tab is usually equal to 10 spaces) to the next tabstop. 

5 After the source program is punched, depress HERE IS to generate trailer tape. 

6 Remove the source program tape from LSP. 


D.2.2 Correcting Typing Errors 

Typing errors can be corrected using the B. SP. button on the tape control and the RUBOUT key on the console 
keyboard. Tbe B. SP. button backspaces the tape one column for each depression of the button, and the 
RUBOUT key perforates all eight channels of the tape (this perforation is ignored by the computer). 


D.2.3 Editing 

Rjnched tapes can be edited off-line. However, the user must be able to read the perforations on the tape, 
otherwise, off-line editing is virtually impossible. The following is a description of the process used to edit 
a paper tape off-line. 
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Procedure 


Step 

1 

2 

3 

4 

5 

6 

7 

8 
9 

Minor Edit; 

Major Edit: 


10 

11 

12 

13 

14 


Turn TTY to LOCAL. 

SET LSR to FREE. 

Put tope to be edited into LSR. 

Depress LSP ON. 

Depress HERE IS to generate leader tape. 

Set LSR to START. 

Observe the printer as the program Is being typed, and 

Set LSR to STOP a few characters ahead of the text to be edited. 

Advance the tape one character at a time by toggling the LSR control from START to STOP. 

Advance tape past the character(s) to be edited and use the B. SP. and RUBOUT keys to erase 
any incorrect characters, then type and punch corrected text. 

Following Step 9: 

a. Set LSR to STOP one character ahead of the text to be edited; 

b . Type new text; 

c. Set LSR to FREE; 

d. Advance tape past edited area (reading the perforated tape); 

e. Set LSR to START. 

Repeat from step 6 until editing is completed. 

Set LSR to START. 

After new source program tape is punched, depress HERE IS to generate trailer tape. 
Remove old tape from LSR and discard.^ 

Remove new tape from LSP and save . 


D.2.4 Listing of a FVinched Paper Tape 

The printer can also be used to obtain a listing of a punched paper tape; this can be done with a minimum of 


t 


It is good programming practice to list the new tape before discarding the old, ensuring that the new tape is 
correct. 
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D.3.3 USASCII Format 


s 


USASQI (USA Standard Code for Information Interchange) format uses all eight 
channels to represent a single character (letter, number, or symbol) as shown in 
the adjacent diagram. 









• • 
• • 


324 

310 

311 
323 
240 
31 \ 
323 
240 
301 
323 
303 
31 1 



S 

A 

S 

c 

I 

I 

F 

0 

R 

M 

A 

T 


D.3.4 Binary Format 

Binary format can be recognized by the absence of a channel 8 punch, an 
occosional channel 7 punch, and frequent sections of blank tc^. The 
channel 7 punch denotes on origin of a program or subprogram or a change 
in origin, and subsequent columru contain the instructions (two columns per 
instruction) or data of succeeding locations. 




ORIGIN 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 

INSTRUCTION 
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APPENDIX E 

SYSTEM CONFIGURATION AND OPTIONAL HARDWARE 


E. 1 INTRODUCTION 

Depending on the hardware configuration of a particular TSS/8, there can be as mony as 24 users working on 
the system simultaneously. The minimum hardware configurotion is designed to service from four to eight users; 
it requires a 12K core memory (three fields). The first 8K (fields 0 and 1) are shared by the various Monitor 
subprograms. The other 4K (field 2) and any additional fields are shared by users of the system. 

Each user has the following resources: 4K core memory for execution of programs and a corresponding 4K disk 
track for temporary storage of his core image when it is swapped out by the Monitor. The disk is divided as 
fol lows: 


a. Monitor Area — The first 20K of the disk is occupied by Monitor subprograms. These subprograms 
are swapped into core memory as needed. 

b. User Swapping Area — This area consists of a 4K track for each user in the system. When a user 
is temporarily swapped out of core, his program is stored on his 4K disk track. 

c. File Storage Area — The remaining disk area is used for storing System Library Programs and user 
files. 

The system can have a maximum of 32K of core memory. Additional fields of core permit overlapping the run 
time of one user program with the swapping time of another, thus increasing operating speed. 

A high-speed, fxiper-tape reader and punch unit is pictured in Figure E-1 and descriptions of the reader and 
punch units follow. 


E.2 READER UNIT 

The high-speed, paper-tape reader is used to photoelectrically input data into core memory from eight-channel 
fan-folded (rK>n-oiled) punched paper tape at 300 characters per second. Power is applied to the reader when 
the computer POWER switch is turned on. The high-speed reader is under program control. However, tape can 
be advanced past the photoelectric sensors without causing input by pressing the FEED button (the white rect- 
angular button shown in Figure E-1). 


E-1 




Figure E-1 High-Speed, Paper-Tape Reader and Punch Units 

E,3 LOADING THE READER UNIT 

The following is a description of the steps necessary to read a paper tape with the high-speed reader. 


Step Procedure 

1 Raise tape retainer cover (located beneath the tape feed button). 

2 Put tape into right-hand bin with channel one (see Section D.2) of the tape toward the 
rear of the bin, 

3 Place several folds of leader tape through the reader and in|-o the left-hand bin. 

4 Place the tape over the reader head with feed holes engaged in the teeth of the sprocket 
wheel . 

5 Close the tape retainer cover. 

6 Depress the tape feed button (white rectangular button shown in Figure E-1) until leader 
tape is over the reader head. 


CAUTION 

Do not use oiled paper tape in the high-speed reader be- 
cause oil collects dust and dirt which can cause reader 
errors. 
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E.4 PUNCH UNIT 


The high-speed, paper-tope punch is used to record computer output on eight-channel fan-fold tape at 
50 charocters per second. All characters are punched under program control from the computer. Blank tape 
(feed holes only, no data) may be produced by pressing the FEED button (see Figure E-I). Power is applied 
to the punch when the POWER button on the punch unit is depressed (the punch motor can be heard). The two 
labeled buttons on the punch unit are described below. 

POWER This button is depressed to turn the punch ON and OFF. 

FEED While this button is depressed, the punch produces feed-hole-only punched tape 

for leader/trailer purposes. 

E.5 DECT APE CONTROL AND TRANSPORT UNITS 

DECtape is a fast, convenient, input/output and data storage facility. The standard DECtape Transport unit is 
shown in Figure E-2. 



Figure E-2 DECtape Transport Unit 
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E.6 CONTROL UNIT 


The DECtape control unit (located internally) interprets and controls the transfer of data between the computer 
and the transport unit. The DECtape control unit is located inside the rack containing the DECtape transport 
and can control up to eight separate DECtape transports. 


E.7 TRANSPORT UNIT 

The DECtape transport unit is a bidirectional magnetic tape transport utilizing a 10-track recording head to read 
and write five duplexed channels. Tape movement can be controlled by commands from the computer program 
or by the manual operation of switches located on the front panel of the transport; however, manual operation 
does not transfer data to the computer. 


NOTE 

Only certified DECtapes (pre-recorded with timing and marking 
tracks) should be used. Otherwise, the blank tape must be cer- 
tified using the DECTOG Program (DEC-08-EUFA-D). 


E.7. 1 Transport Controls 

The following is a description of the settings on the DECtape transport and their functions. 


Settings 



REMOTE 

OFF 

LOCAL 


Unit Selector 

WRITE 

ENABLED 


Function 

When depressed (must be in LOCAL mode), tape feeds onto 
right spool . 

Transport is energized and under program control . 

Transport is de-energized. 

Transport is energized and under user control from external 
transport switches. 

Identifies the transport to the control unit. 

DECtape is available for search, and write activities. 


WRITE LOCK 



DECtape is available for search and read activities only. 

When depressed (must be in LOCAL mode), tape feeds 
onto left spool . 
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NOTE 


The REMOTE and WRITE ENABLED lamps light to indicate the 
status of the transport. 


E.7.2 Operating Procedure 

The following is a description of how to mount a DECtape on a transport unit. 


Step Procedure 

1 Set Switch to OFF . 

2 Place DECtape on left spindle with DECtape label out. 

3 Wind four turns of tape on right spool. 

4 Set switch to LOCAL. 


5 Wind a few turns on right spindle with switch to make sure 
tape is properly mounted. 

6 Dial correct unit number on unit selector (number 8 is equivalent 
to 0). 

7 Set switch to REMOTE. Select either WRITE ENABLE or WRITE 
LOCK setting. 


E-5 



APPENDIX F 
STORAGE ALLOCATION 


F.l STORAGE MAP 

The system's storage allocation is illustrated below. 


CORE MEMORY 


RESIDENT 

RESIDENT 

PHANTOMS 

INIT 

USER 

1 f 

USER 

USER 

MONITOR 

MONITOR 

UStH 

PROGRAM 

PROGRAM 

PROGRAM 

4K 

4K 

PROOPAM 

4K 

4K 
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4K 


DISK STORAGE 



08-0466 


Rgure F-1 TSS/8 Storage Map 

F.2 RLE DIRECTORIES 

There are two directories on the disk: the Master File Directory (MFD) referenced mainly by the system, and 
the User RIe Directory (UFD), referenced by the TSS/8 user. One of the functions of the MFD is to service 
the UFD. A UFD is a particular user’s file directory containing the names of programs he has created on the 
disk. 

The UFD is a file like any other file except that its filertame is the project-programmer number and password. 

(See Section F.3 for an explanation.) When a user is logged in under a specific number and references the disk, 
he is actually referencing his own file area on the disk through the UFD which has his project-programmer num- 
ber as its name. He can specifically code his routine to reference UFDs of other users or the MFD; whether he 
is successful or not depends on the type of protection that has been specified for the area he is trying to reference. 
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MASTER FILE OIRECTORY 


USER FILE OIRECTORY 


WORD 1 


WORD 8 


PROJECT NO 

PROG NO 

( 1 CHAR) 

PA 

ss 

(t CHAR ) 

( 1 CHAR ) 

WO 

RO (1CHARJ 1 

LINK TO NEXT ENTRY | 

UNUSEO 

PRC'TEi TED 1 
BIT^ 1 

1 CONSOLE TIME | 

CPU 

TIME 


POINTER 

TO 

RETRIEVAL 


(1 CHAR ) 

FI 

LE 

(tCHAR ) 

(1 CHAR ) 

NA 

ME 

(1 CHAR ) 

(1 CHAR ) 

WO 

RD 

(1 CHAR.) 

LINK TO NEXT ENRTY 

1 UNUSEO 

PROTECTED BITS 

SEGMENT COUNT 

date of 

creation 

POINTER 

to 

RETRIEVAL 


« 1 

SEGMENT 

# 1 

SEGMENT 

#2 

SEGMENT 

# 3 

SEGMENT 

« 4 

SEGMENT 

# 5 

SEGMENT 

# 6 

SEGMENT 

# 7 


1 LINK TO NEXT RETRIEVAL BLOCK | 

SEGMENT 

# 1 

SEGMENT 


SEGMENT 

^ 3 

SEGME NT 

#4 

SEGMENT 

# 5 

SEGMENT 

# 6 

SEGMENT 

# 7 
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F.3 PROJECT-PROGRAMMER NUMBERS 

System account numbers are a combination of project number and programmer number. The account number 
(always written in octal) has a binary equivalent. When expressed os a 12-bit binary number, the project 
number is formed by the leftmost 7 bits and the programmer number is the rightmost 5 bits. For example, the 
account number 623 (octal) equals 000 110 010 011 (binary). The left 7 bits (leading zeros included if any) 
are 0001100 (binary) and equal 14 (octal) which is the project number. The programmer number is 10011 (binary) 
or 23 (octal). Therefore a user with "account number" 623 has: 

project number 14 
programmer number 23 
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APPENDIX G 

GLOSSARY OF ABBREVIATIONS AND TERMS 


G.l COMMONLY USED ABBREVIATIONS 

The abbreviafions listed below ore used throughout the guide. 


Abb. 

Meaning 

Abb. 

Meaning 

AC 

Accumulator 

HSP 

High-Speed Punch 

ADDR 

Address 

HSR 

High-Speed Reader 

B. SP. 

Back Space 

IF 

Instruction Reid 

BIN 

Binary 

INST 

Instruction 

CLC 

Current Location 

KBRD 

Keyboard 


Counter 

L 

Link 

CONT 

Continue 

LF 

Line Feed 

CR 

Carriage Return 

LOAD ADD 

Load Address 

CR/LF 

Carriage Return- 

LOC 

Location 


Line Feed 

LSP 

Low-Speed Punch 

CTRL/FORM 

Control/Form (which repre- 

LSR 

Low- Speed Reader 


sents holding down the 

MA 

Memory Address 


CTRL key while depressing 

MB 

Memory Buffer 


the Form key). 

MQ 

Multiplier Quotient 

DEC 

Digital Equipment 

MRI 

Memory Reference Instruction 


Corporation 

PC 

Program Counter 

DEP 

Deposi t 

PROG 

Program 

DF 

Data Reid 

REL 

Release 

EAE 

Extended Arithmetic 

RIM 

Read- In Mode 


Element 

SING INST 

Single Instruction 

EXAM 

Examine 

SING STEP 

Single Step 



SR 

Switch Register 



TTY 

Teletype 


G .2 GLOSSARY OF TERMS 

The following list of computer/programming terms is by no means complete. However, it does include many of 
the terms used in data processing. 

Absolute (1) An address that is permanently assigned by the machine designer to a storage loca- 

Address tion. 

(2) A pattern of characters that identifies a unique storage location without further 
modification. 
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Accumulator 


A register in which the result of an operation is formed; Abbreviation AC 


Acronym 

Accuracy 

Address 

Address 

Register 

Algorithm 

Alphabet 

Alphanumeric 

Arithmetic Unit 

ASCII 

Assemble 

Assembler 

Auto-Indexing 

Auxiliary 

Operation 

Auxiliary 

Storage 

Binary 

Binary Digit 
Bit 

Blank Character 
Block 


A word formed from the first letter or letters of the successive words of a multiple 
word term . 

The degree of freedom from error, i.e. , the degree of conformity to truth or to a rule. 

A label, name, or number which designates a register or a location where information 
is stored. That part of an instruction which specifies the location of on operand. 

A register in which an address is stored. 


A prescribed set of well-defined rules or processes for the solution of o problem in a 
finite number of steps. 

An ordered set of unique representations called characters, e.g., the 26 letters of 
the Romon alphabet. 

Pertaining to a character set that contains both letters and numerals, and usually 
other characters. 

The component of a computer where arithmetic and logical operotions are performed. 

An abbreviation for USA Standard Code for Information Interchange. 

To translate from a symbolic (source) program to a machine language (object) program 
by substituting binary operation codes for symbolic operation codes and absolute or 
relocatable addresses for symbolic addresses. 

A program that assembles. 

When an absolute location 0010 through 0017 is addressed indirectly, the content of 
that location is incremented by one, rewritten in that same location, and then read 
os the effective address of the next instruction. 

An operation performed by equipment not under direct control of the computer. Off- 
line operation. 

Storage that supplements the primary storage. 


(1) Pertaining to a characteristic or property involving a selection, choice, or con- 
dition in which there are two possibilities. (2) Pertaining to the numeration system 
with a radix of two. 

One of the symbols 1 or 0. A digit in the binary scale of notation; called a bit. 

A binary digit. 

A character used to produce a space on an output device. 

A set of things, such as words, characters, or digits, handled as a unit. 
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Bootstrap 


Branch 

Buffer Storage 

Byte 

Call 

Calling 

Sequence 

Carriage Return 

Central Proces- 
sing Unit 

Character 

Clear 

Closed 

Subroutine 

Coding 

Command 

Compile 

Compiler 

Complement 

Computer 

Computer 

Program 


A technique or device designed to bring itself into a desired state by means of its 
own action, e.g. , a routine w/hose first few instructions ore sufficient to bring the 
rest of itself into the computer from an input device. 

A point in a routine where one of two or more choices is made under control of the 
routine, i.e., a conditional transfer (jump). 

A part of core memory where information is stored temporarily during transfer; it may 
attempt to match the speeds of internal computation and the l/O device, thus permit- 
ting simultaneous computation and input/output. 

A group of binary digits usually operated upon as a unit, e.g. , 8-bit or b-bit byte. 

To transfer control to a specified routine. 

A specified set of instructions and data necessary to set up and call a given routine. 


The Teletype operation that causes the next character to be printed at the left margin. 

The unit of a computing system that includes the circuits controlling the interpretation 
and execution of instruction; the computer proper, excluding l/O and other peripheral 
devices. 

A single letter, numeral, or space mark used to represent information. 

To erase the contents of a storage location by replacing the contents with blanks or 
zeros. 

A subroutine not stored in the main part of a program. Such a subroutine is entered 
by a jump operation and provision is made to return control to the main routine at 
the end of the surbroutine. 

To write instructions for a computer using symbols meaningful to the computer. 

A control signal , usually written as a character or group of characters, to direct 
action by a system program. 

To produce a machine language routine from a routine written in source language by 
selecting appropriate subroutines from a subroutine library, as directed by the instruc- 
tions or other symbols of the original routine, supplying the linkage which combines 
the subroutines into a workable routine and translating the subroutines and linkage 
into machine language. 

A program that compiles. 

To form the negative of a binary word by replacing all 0 bits with 1 bits and vice versa. 

A device capable of accepting information, processing it, and providing the results 
in a usable form. 

A plan or routine for solving a problem on a computer. 
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Computer Word 

Console 

Control 

Character 

Control Panel 

Convert 

Copy 

Core Memory 

Cycle 
Cycle Time 
Data 

Data Break 

Debug 

Decision 

Delay 

Delimiter 

Diagnostic 

Digit 

Digital 

Computer 

Direct Address 

Display 

Document 

Double 

Precision 

Downtime 


A sequence of 12 bits treated as a unit and capable of being stored in one computer 
location. 

Usually the external front side of a device where controls and indicators are available 
for manual operation of the device. 

A character whose occurrence in a particular context initiates, modifies, or stops a 
control operation, e.g., a character to control carriage return. 

The part of a device console that contains manual controls. 

To change the representation of data from one form to another. 

To reproduce data, leaving the original data unchanged. 

The main storage device in the PDP-8 in which binary data is represented by the 
direction of magnetization in each unit of an array of magnetic material. 

To repeat a set of operations until a stated condition is met. 

An interval of time in which one set of events is completed. 

A general term used to denote any or all facts, numbers, letters, and symbols. It con- 
notes basic elements of information which can be processed or produced by a computer. 

A facility which permits l/O transfers to occur simultaneously with program execution 
on a cycle-stealing basis. 

To detect, locate, and correct mistakes in a program. 

A determination of future action. 

The amount of time by which an event is retarded. 

A character that separates and organizes items of data. 

Pertaining to the detection and isolation of a malfunction or mistake. 

A character used to represent one of the non-negative integers smaller than the 
radix, e.g., in binary notation, either 0 or 1. 

A device that operates on discrete data, performing sequences of arithmetic and 
logical operations on this data. 

An address that specifies the location of an operand. 

A visual presentation of data. 

A medium on which information is recorded for human or machine use. 

Pertaining to the use of two computer words to represent a number. 


The time interval during which a device is inoperative. 
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Dummy 


An artificial address, instruction, or record of information inserted solely to fulfill 
prescribed conditions. 


Dump 


To copy the contents of all or part of core memory, usually onto an external storage 
medium. 


Dynamic Dump 
Edit 

Effective 

Address 

End-Around 

Carry 

Execute 

Executive 

Routine 

External 

Storage 

File 

Fixed Point 

Flip-Flop 
Floating Point 

F lowchart 

Format 

Function 

Flardware 

Head 

Heuristic 

I/O 

Identifier 

Indirect 

Address 


A dump that is performed during the execution of a program. 

To rearrange information for machine input or output. 

The address actually used in a particular execution of a computer instruction. 

The action of adding the most significant bit of a binary number to the least significant 
bit. 

To carry out an instruction or run a progran on the computer. 

A routine that controls or monitors the execution of other routines. 

A facility or device, not an integral port of the computer, on which data usable by 
the computer is stored, such as poper tope, DECtape, or DECdisIc. 

A collection of related recortfe treated as a unit, generally data or a program. 

In a numeration system the position of the radix point is fixed with respect to one end 
of the numerals, according to some convention. 

A basic computer circuit or device capable of assuming either one of two stable 
states at a given time. 

A numeration system in which the position of the radix point is indicated by one part 
(the exponent part), the other part represents the significant digits (the fractional part). 

A graphical representation of the sequence of instructions required to carry out a data 
processing operation. 

The arrangement of data. 

A specific purpose of an entity or its characteristic action. 

Physical equipment, e.g., mechanical, electrical, or electronic devices. 

A device that reads, records, or erases data on a storage device. 

Pertaining to exploratory methods of problem solving. 

Input or output or both. 

A symbol whose purpose is to identify, indicate, or name a body of data. 

An address in a computer instruction which indicates a location where the address of 
the referenced operand is to be found. 
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Initialize 


Input 

Instruction 

Internal 

Storage 

Interrupt 

Jump 

Label 

Language 

Leader 

Least Significont 
Digit 

Library 

Library 

Routine 

Load 

Location 

Loop 

Machine 

Instruction 

Machine 

Language 

Macro 

Instruction 

Manual Input 

Manual 

Operation 

Memory 


To set counters, switches, and addresses to zero or other starting values at the 
beginning of, or at prescribed points in, a computer routine. 

The transferring of data from auxiliary or external storage into the internal storage 
of the computer. 

A set of bits (in an object program) or characters (in a source program) which as a 
unit cause the computer to perform an operation. 

The storage facilities forming an integral physical part of the computer and directly 
controlled by the computer. Also called main memory and core memory. 

To stop a process in such a way that it can be resumed. 

A departure from the normal sequence of executing instructions in a computer. 

An identifier. 

A set of representations, conventions, and rules used to convey information. 

The blank section of tape at the beginning of the tape. 

The rightmost digit of a birwry number. 


An organized collection of stondard and proven routines and subroutines which can 
be incorporated in larger routir>es. 

A proven routine that is maintained in a program library. 


To place data into internal storage. 

A place in storage or memory where a unit of data or an instruction may be stored. 

A sequence of instructions that is executed repeatedly until a terminal condition 
prevails. 

An instruction written in machine language. 


A language designed for interpretation and use by the machine without translation. 


An instruction in a source language that is equivalent to a specified sequerKe of 
machine instructions. 

The entry of data by hand into a device at the time of processing. 

The processing of data in a system by direct manual techniques. 


(1) The erasable storoge in the computer. (2) Pertaining to a device in which 
data can be stored and from which it con be retrieved. 
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No Op 


An insfruction that specifically instructs the computer to do nothing, except to 
proceed to the next instruction in sequence. 


Object Program The machine language program which is the output after translation from the source 
language. The binary program which runs on the computer. 

Octal (1) Pertaining to a characteristic or property involving a selection, choice, or con- 

dition in which there are eight possibilities. (2) Pertaining to the numeration system 
with a radix of eight. 


Off Line 


Pertaining to equipment or devices not under direct control of the computer. 


On Line 


Open 

Subroutine 


Pertaining to equipment or devices under direct control of the computer; also to pro- 
grams operating directly and immediately to user commands, e.g. , FOCAL and DDT. 

A subroutine that must be relocated and inserted into a routine at each place it is 
used. 


Operand 

Origin 

Output 


That which is effected, manipulated, or operated upon. 

The absolute address of the beginning of a program. 

Information transferred from the internal storage of a computer to output devices or 
external storage. 


Overflow 

Page 

Patch 

Predefined 

Process 

Procedure 

Processor 


Program 

Program 

Library 


The generation of a quantity beyond the capacity of a register. 

In the PDP-8/1, a unit of 200 (octal) locations which may be addressed directly. 
To modify a routine in a rough or expedient way. 

A named process consisting of one or more operations or program steps that ore 
specified elsewhere in a routine. 

The course of action taken for the solution of a problem. 

A computer program that Includes the compiling, assembling, translating, and 
related functions for a specific programming language. 

The complete sequence of instructions ond routines necessary to solve a problem. 
A collection of available computer programs and routines. 


Programming A language used to prepare computer programs. 
Language 


Protected A storage location reserved for special purposes in which data cannot be stored with- 

Location out undergoing a screening procedure to establish suitability for storage therein. 


Punched A paper tape on which a pattern of holes is used to represent data. 

Paper Tape 


Pushdown A list that is constructed and maintained so that the next item to be retrieved is the 

List most recently stored item in the list, i.e., last in, first out. 
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Radix 

Read 

Real Time 

Record 

Regisfer 

Reset 

Restart 

Routine 

Run 

Scan 

Search 

Set 

Single Step 
Skip 

Software 

Source 

Language 

Source Program 

Statement 

Step 

Storage 

Allocation 

Storage 

Capacity 

Storage 

Device 

Store 


The quantity of characters for use in each of the digital positions of a numbering system. 

To transfer information from an input device to internal storage; also refers to the in- 
ternal acquisition of data from memory. 

Pertaining to computation performed while the related physical process is taking place 
so that results of the computation can be used in guiding the physical process. 

A collection of related items of data, treated as a unit. 

A device capable of storing a specified amount of data, such as one word. 

To restore a storage device to a prescribed state. 

To re-establish the execution of a program. 

A set of instructions arranged in proper sequence to cause the computer to perform 
a desired task. 

A single, continuous performance of a program. 

To examine sequentially port by part. 

To examine a set of items for those that hove a desired property. 

To place a storage device into a specified state. 

Operation of the computer in v^4»ich each instruction is performed in response to a 
single manual operation. 

To ignore one or more instructions in a sequence of instructions. 

The collection of programs and routines associated with the computer. 

A symbolic language that is an input to a given translation process. 

A program written in a symbolic (source) language. 

A meaningful expression or generalized instruction in a source language. 

One operation in a routine. 

The assignment of blocks of data to specified blocks of storage. 

The amount of data that can be contained in a storage device. 

A device into which data can be entered, in which it can be held, and from which it 
can be retrieved. 

To enter data into a storage device. 
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String 
Subroutine 
Swi tch 

Symbolic Address 

Symbolic 

Coding 

System 

Tope Drive 

Temporary 

Storage 

Terrninal 

Time Sharing 

Toggle 

Translate 

Underflow 

Variable 

Word 

Word Length 
Write 


A connected sequence of entities such as characters in a command string. 

A routine that can be part of another routine. 

A device or programming technique for making selections. 

An address expressed in symbols convenient to the programmer. A label . 

Writing instructions using symbolic notation instead of actual machine instruction 
notation. 

An assembly of software and hardware united to form an organized whole. 

A device that moves tape past a head. 

Storage locations reserved for intermediate results. 

A point in a system at which data con either enter or leave. 

The interleaving of the time of a device. 

Pertaining to the operation of a flip-flop or switch. 

To convert from one language to another. 

The condition that arises when a computation yields a result whose magnitude is 
smaller than the system is capable of representing. 

A quantity that can assume any of a given set of values. 

A 12-bit unit of data in the PDP-8/1 which may be stored in one addressable location. 
The number of bits in a word. 

To transfer information from internal storage to an output device or to auxiliary 
storage . 
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ASSIGN, 2-7 
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Command Summary, 3-7 
Editing Phase, 3-5 
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Calling Monitor, 2-1 
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Calling, 6-7 
Example Usage, 6-7 

CATALOG, see CAT 
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CLOSE, 8-4 

Closing a File, 8-4 


Command Summary, B-1 , C-1 
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CREATE, 8-3 

Creating a Disk File, 8-2 

Creation of System Library Programs, 8-1 

CTRL/B, 2-1, 3-3, 8-2 

CTRL/BS, 2-2, 3-4 

CTRL/C, 3-3 


Debugging Program, 6-5 
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Control and Transport Units, E-3 
Transport Controls, E-4 
Transport Operating Procedures, E-5 
Usage, 7-5 

Defining Disk Files, 8-3 
Deleting Files, 7-7, 7-8 
Delimiters, 9-16 
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Load Punch Buffer Sequence (PLS), 9-1 1 
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Punch String (PST), 9-11 

Reader Fetch Character (RFC), 9-10 

Read Reader Buffer (RRB), 9-10 

Read Reader String (RRS), 9-10 
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Release Device (REL), 9-10 

Skip on Flags (DTSF), 9-10 
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Skip on Reader Flag (RSF), 9-10 

DUPLEX, 8-8 

Duplicating Paper Tapes, D-1 
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Command Summary, 6-3 

Summary of Operations, 6-2 
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Error Messages, Monitor, 2-9 

EXAMINE, 8-2 

EXTEND, 8-4 


F, 8-5 
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File and Disk I/O (PAL-D), 9-4 

Close File (CLOS), 9-7 
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Open File (OPEN), 9-7 
Protect File (PROT), 9-6 
Read File (RRLE), 9-7 
Reduce File (RED), 9-6 
Rename File (REN), 9-6 
Write File (WFILE), 9-7 

File Deletion Error Conditions, 8-6 
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File Information Command, 8-5 

File Protection Masks, 8-5 

File Protect, 3-3 

FOCAL, 3-13 

Calling, 3-13 

Command Summary, 3-13 

Control Characters, 3-16 

Error Messages, 3-17 

Example Program, 3-17 

Math Functions, 3-16 

MODIFY, 3-15 

Output Format, 3-15 

Reading FOCAL Paper Tapes, 3-17 

Formats, Paper Tape, D-4 

FORTRAN-D, 4-1 

Calling, 4-1 

Compiler Diagnostics, 4-6 
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Disk Files, 4-3 
Editing, 4-2 
Example Programs, 4-4 
FORT, 4-1 
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I/O, 4-2 

Operating System Diagnostics, 4-8 
Statement Summary, 4-5 

Freeing Devices, 2-8 
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High Speed Reader, E-1 
High Speed Punch, E-3 
How to Use This Manual, 1-5 

ILLEGAL REQUEST, 2-10 

lOT's, see 

Console 

Device 

File and Disk 

Program and System Status 

Program Control 

Initialize Reader/Punch, 9-17 

Internal File Numbers, 8-3 

Interrupt Processing, 9-17 

Keyboard, 1-4 


Leader/Trailer Format, D-4 

LINE-OFF-LOCAL Knob, 1-3 

Listing a Paper Tape, D-3 

Listing Directories, 7-7 

LOAD, 8-7 

LOADER, 6-4 

Calling, 6-4 
Usage, 6-4 
With ODT, 6-5 

Loading Files from DECtape, 7-6 
Loading High Speed Reader, E-2 
LOGIN PLEASE?, 2-10 
LOGIN Procedure, 2-2 
Logout Procedure, 2-4 
Low Speed Printer, 1-3 


Manual, How to Use, 1-5 

Master File Directory, F-1 

Monitor, 1-1 

Calling, 2-1 
Commands, 2-1, 8-2 
Command Abbreviations, 8-2 
Echoing on Keyboard, 9-16 
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Error Messages, 2-9, 8-6 
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Mounting a DECtape, E-5 

Multiple Device Assignments, 2-8 

Multiple Device Units, 2-7 

O 

Octal Debugging Technique, see ODT 

ODT, 6-5 

Calling, 6-5 
Command Summary, 6-6 
Programming Notes, 6-6 

Off-Line Tape Preparation and Editing, D-1 

OPEN, 8-3 

Opening a File, 8-3 

Optional Hardware, E-1 
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Example Program, 5-2 
File and Disk I/O, 9-4 
Full-Duplex Hardware, 9-2 
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Symbol List, 5-3 
TSS/8 PAL-D, 5-1 9-1 
Writing a Program, 5-2, 9-1 
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Paper Tape Format's, D-4 
Paper Tape Preparation, D-1 
Paper Tape Reader/Punch, 1-4 
PDP-8 Compatibility, 9-16 
PIP, 7-1 

BIN Format Files, 7-3 
Calling, 7-1 
Deleting Disk Files, 7-3 
Loading Paper Tape onto Disk, 7-1 
Moving Disk Files, 7-3 
Punching out a Disk File, 7-2 
Summary of Options, 7-5 
Transferring BASIC Files, 7-4 
Transferring SAVE Format Files, 7-4 
With High Speed Reader/Punch, 7-2 

Power Control Knob, 1-3 

Processing Interrupts, 9-17 

Program and System Status lOT's, 9-13 

Account (ACT), 9-15 

Check Status (CKS), 9-13 

Console Number (CON), 9-15 

Current JOB (WHO), 9-15 

Current Job Number (USE), 9-15 

Date (DATE), 9-15 

OR with Switch Register (OSR), 9-14 

Quantum Synchronization (SYN), 9-16 

Return Clock Rate (RCR), 9-15 
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Segment Size (SIZE), 9-15 

Set Switch Register (SSR), 9-14 

Set Time (STM), 9-16 

Skip on TSS/B (TSS), 9-16 

Time of Day (TOD), 9-15 

User Run Time (URT), 9-15 

Program Control lOT's, 9-12 

Halt (HLT), 9-12 

Set Error Address (SEA), 9-13 

Set Restart Address (SRA), 9-13 

Project-Programmer Number, F-2 

PROTECT, 8-5 

Protection Codes, 8-4 

Protection of Files, 3-3 


Reader/Punch Initialization, 9-17 

REDUCE, 8-4 
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RENAME, 8-4 

Resources, 2-6 

RESTART, 8-8 

Return to Monitor Level, 3-4 
RIM Format, D-4 
RUN, 8-8 

SAVE, 8-6 

SAVE Format Files, 8-6 

Saving Disk Files on DECtape, 7-7 

START, 8-2 

Status Words, 9-13 

Storage Allocation, F-1 

Storage Map, F-1 
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Logging In and Out, B-1 
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File Handling, B-2 
Control of User Programs, B-3 
Utility Commands, B-3 

Summary of TSS/8 lOT's, C-1 

DECtape Control (TCOl), C-2 
File Control, C-1 

High Speed Reader and Control (PC02), C-2 
Input Buffer Control , C-2 
Output Buffer Control, C-2 
Program Control, C-1 

SWITCH, 8-8 

Switch Register, 9-14 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements of new and revised software, as well as programming notes, software problems, and documentation 
corrections are published by Software Information Service in the following newsletters: 

Digital Software News for the PDP-8 Family 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information to update the cumulative 

Software Performance Summary for the PDP-8 Family 
Software Performance Summary for the PDP-9/15 Family 

The appropriate edition of the Software Performance Summary is included in each basic software kit for new customers. 
Additional copies may be requested without charge. 

Any questions or problems on the articles contained in these publications or concerning the use of Digital’s software should 
be reported to the Software Specialist or Sales Engineer at the nearest Digital office. 

New and revised software and manuals, current issues of the Software Performance Summary, and cumulative Software 
Manual Updates are available from the Program Library. To place an order, please contact your local Digital office or 
write to: 


Program Library 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

When ordering, include the code number and a brief description of the program or manual requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library and publishes a catalog of available programs 
as well as the DECUSCOPE magazine for its members and non-members who request it. For further information, please 
write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street 

Maynard, Massachusetts 01754 

Please complete the return postcard below if you would like to receive Digital’s newsletters 

Send I I Digital Software News for the PDP-8 Family, or 

I I Digital Software News for the PDP-9/15 Family 

To Name 

Company Name 

Address 


(zip code) 

□ PDP-12 □PDP-9 

□ LINC-8 □PDP-15 

Q Other 


My computer is a O PDP-8I 

□ PDP-8L 

□ PDP-8S 
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READER'S COMMENTS 


TSS/8 TIME-SHARING 
SYSTEM USER'S GUIDE 
DEC-T8-MRFB-D 

Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness of its 
publications. To do this effectively we need user feedback — your critical evaluation of this manual. 

Please comment on this manual’s completeness, accuracy, organization, usability, and readability. 



DbC also strives to keep its customers informed of current DEC software and publications. Thus, the following period- 
ically distributed publications are available upon request. Please check the appropriate boxes for a current issue of the 
publication(s) desired. 

Q Software Manual Update, a quarterly collection of revisions to current software manuals. 

Q User's Bookshelf, a bibliography of current software manuals 

Q Program Library Price List, a list of currently available software programs and manuals. 

Please describe your position. 

Name Organization 

Street Department 



City 


State 


Zip or Country 
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